Linear MCP Server

Linear MCP Server とは？

Linear MCP Server は jerhadf によるコミュニティ製の linear mcp server で、Claude などの MCP クライアントが Linear API を通じて Linear の issue を検索、作成、更新、コメントできるようにします。現在は非推奨となっており、Linear 公式のリモート MCP サーバーへの移行が推奨されています。

このプロジェクトは MIT ライセンスの Node.js パッケージで、npm で linear-mcp-server（最新バージョン 0.1.0）として公開されていますが、すでにメンテナンスされていません。新規セットアップ向けに、Linear は https://mcp.linear.app/mcp で公式サーバーをホストしており、ドキュメントは linear.app/docs/mcp にあります。このページでは、ここに掲載されている元のパッケージと、現在ほとんどの人が使うべき公式の linear mcp エンドポイントの両方を説明します。

Linear MCP Server の使い方

推奨：Linear 公式リモート MCP サーバー

Linear がホストするサーバーは https://mcp.linear.app/mcp で Streamable HTTP を使い、OAuth 2.1 でサインインします。そのため、ほとんどのクライアントではインストールも API キーの貼り付けも不要です。読み取り専用エンドポイントは https://mcp.linear.app/mcp/readonly です。古い https://mcp.linear.app/sse エンドポイント（非推奨の README が指しているもの）は、現在はレガシーのフォールバックです。

Claude Code：

claude mcp add --transport http linear-server https://mcp.linear.app/mcp

その後、Claude Code のセッション内で /mcp を実行して認証を完了します。

Codex：

codex mcp add linear --url https://mcp.linear.app/mcp

Claude（claude.ai と Claude Desktop）：Settings > Connectors から Linear コネクタを追加します。Cursor：Cursor の MCP tools ページから Linear をインストールします。VS Code、Windsurf など、リモートサーバーをネイティブにサポートしないクライアントでは mcp-remote を使えます。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

レガシー：jerhadf の linear-mcp-server パッケージ

元のローカルサーバーが引き続き必要な場合は、Node.js と、https://linear.app/YOUR-TEAM/settings/api で取得した Linear API キーが必要です。

Claude Desktop

macOS では ~/Library/Application Support/Claude/claude_desktop_config.json に次を追加します。

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

README には Smithery による自動インストールも記載されており、この mcp.so ページに表示されている設定はこれにあたります。

npx @smithery/cli install linear-mcp-server --client claude

Linear MCP Server の主な機能

• タイトル、チーム、markdown の説明、優先度（0-4）、ステータスを指定して Linear の issue を作成・更新。
• テキスト、チーム、ステータス、担当者、ラベル、優先度で issue を検索し、件数を制限可能。
• ユーザーに割り当てられた issue を一覧表示（アーカイブ済みも含められる）。
• issue に markdown コメントを追加（任意でカスタムのユーザー名とアバターを指定可能）。
• 単一の issue、チームの issue、ユーザーの担当 issue、組織、現在のユーザーを表す MCP リソース。
• LINEAR_API_KEY 環境変数ひとつで、stdio 経由でローカル実行。
• 非推奨：今後の修正はありません。Linear 公式のリモートサーバーは OAuth で issue、プロジェクト、コメントを扱えます。

Linear MCP Server のツール

この非推奨パッケージは 5 つのツールを 2 つのグループで提供します。

• issue 管理：linear_create_issue はチーム内に issue を作成し（title と teamId が必須）、linear_update_issue は issue ID を指定してタイトル、説明、優先度、ステータスを変更します。
• 作業の検索とディスカッション：linear_search_issues はクエリ、チーム、ステータス、担当者、ラベル、優先度で issue を絞り込みます。linear_get_user_issues はユーザーに割り当てられた issue を返します（デフォルトは認証済みユーザー）。linear_add_comment は issue にコメントを投稿します。

さらに linear-issue:///{issueId}、linear-team:///{teamId}/issues、linear-viewer: などのリソース URI も提供します。Linear 公式 MCP サーバーには、issue、プロジェクト、コメントを検索・作成・更新するための、より幅広い独自のツールセットがあります。

Linear MCP Server のユースケース

• 自分のキューを整理する：「Show me all my high-priority issues.」
• 会話からバグを登録する：「Based on what I've told you about this bug already, make a bug report for the authentication system.」
• 進行中の作業を探す：「Find all in progress frontend tasks.」
• 最近の動きを要約する：「Give me a summary of recent updates on the issues for mobile app development.」
• チームの負荷を確認する：「What's the current workload for the mobile team?」
• 公式サーバーでは、Linear のサンプルプロンプトにあるように、スタンドアップのメモを issue コメントに変換したり、計画ドキュメントを Linear プロジェクトに変換したりできます。

Linear MCP Server と代替ツールの比較

• Linear 公式 MCP サーバーとこのパッケージ：ホスト型サーバーは Linear がメンテナンスし、ローカルインストール不要で、OAuth（または bearer token / API キー）を使い、読み取り専用エンドポイントを備え、Claude、Cursor、Codex などでネイティブに動作します。jerhadf の linear mcp server はローカル実行、API キーのみ、かつメンテナンスされていません。
• 他のトラッカー：Jira なら Jira MCP Server または Atlassian MCP、Asana なら Asana MCP Server、ClickUp なら ClickUp MCP Server を参照してください。
• コードホスティング：Linear と GitHub MCP Server を組み合わせれば、issue と pull request を関連付けられます。

Linear MCP Server のトラブルシューティング

• パッケージが動かない、または機能が足りない：このパッケージは非推奨です。上記のクライアント手順で https://mcp.linear.app/mcp に移行してください。
• 公式サーバーへの接続時に internal server error が出る：Linear のドキュメントでは、rm -rf ~/.mcp-auth で保存済みの認証情報を消去して再試行し、必要に応じて Node.js を更新するよう案内されています。
• SSE エンドポイントのエラー：https://mcp.linear.app/sse は非推奨のフォールバックです。Streamable HTTP エンドポイントを使ってください。
• Windows の WSL でのエラー：Linear は、wsl 経由で mcp-remote を実行し、/sse エンドポイントと --transport sse-only を使うフォールバックを記載しています。
• ワークスペースが違う：Linear のワークスペースごとに別の認証コンテキストが必要です。mcp-remote では、ワークスペースごとに異なる MCP_REMOTE_CONFIG_DIR を設定してください。