Skip to main content
Glama

mcp-linear

Linear の課題操作を公開する MCP サーバー。スタンドアロンで動作し、組み込みの Claude Linear MCP への依存はありません。

課題は人間が読める識別子(GOV-123)で指定します。ステート、チーム、ラベル、担当者は名前で指定し、サーバーが Linear UUID に解決します。名前が一致しない場合は、有効な選択肢を列挙したエラーを返します。

ツール

ツール

説明

get_issue

識別子で課題を取得する

list_my_issues

API キーの所有者に割り当てられた課題

search_issues

チーム/ステート/担当者フィルター付きの全文検索

create_issue

チームに課題を作成する

update_issue

既存の課題のフィールドを更新する

get_comments

課題のコメント

add_comment

コメントを投稿する

list_teams

チームのキーと名前

list_states

チームのワークフローステート

list_labels

チームのラベルとワークスペースラベル(チームは任意)

list_users

アクティブなユーザー

Related MCP server: Linear MCP Server

セットアップ

python3 -m venv .venv
.venv/bin/pip install -e ".[dev]"
cp .env.example .env
# Edit .env — set LINEAR_API_KEY

API キーを取得する: Linear → 設定 → セキュリティとアクセス → 個人用 API キー。書き込み操作には書き込みアクセス権のあるキーが必要です。

Claude Code に追加

{
  "mcpServers": {
    "linear": {
      "command": "/Users/piuschungath/Workspace/mcp-linear/.venv/bin/mcp-linear",
      "env": { "LINEAR_API_KEY": "lin_api_..." }
    }
  }
}

テスト

.venv/bin/pytest

すべての HTTP は respx でモック化されています。API キーもネットワークアクセスも不要です。

mcp-pr-assistant との連携

2 つのサーバーは相互にインポートせずに連携できます。get_issue でチケットを取得し、そのフィールドを create_pr_from_ticket に渡し、PR の URL を add_comment で投稿します。

スキーマ検証

src/mcp_linear/queries.py の GraphQL フィールド名は、2026-08-21 に実在の Linear API に対して検証済みです。ツールが実際に使用するクエリ文字列(コピーではなく)を実在のワークスペースに対して実行して確認しました。

検証済みの項目:

  • Float! の課題番号コンパレータ

  • team { labels } によるチームスコープのラベル

  • ルートの issueLabels コネクション

  • viewer.assignedIssues(orderBy: updatedAt)

  • 3 つのミューテーションが送信するすべてのフィールド — IssueCreateInput、IssueUpdateInput、CommentCreateInput はすべて、使用されている teamId、title、description、stateId、assigneeId、priority、labelIds、issueId、body を受け入れます

1 つの相違が見つかり、修正されました:

  • 全文検索。 issueSearch は query 引数を非推奨として拒否します。検索は現在 searchIssues(term: ...) を使用します。これは IssueSearchPayload を返し、そのノードは IssueSearchResult であり、Issue ではありません。そのため IssueFields フラグメントを展開できません。queries.py は、その型に対して同一の選択セットを持つ 2 つ目のフラグメント SearchFields を宣言しています。イントロスペクションにより、IssueSearchResult は IssueFields が選択するすべてのフィールドを備えていることが確認されました。一方のフラグメントを変更したら、もう一方も変更してください。

1 つの項目が未確認のままです:

  • ワークスペースラベル。 ルートの issueLabels コネクションは解決されますが、ワークスペース全体のラベルのみを返すのか、他のチームに属するチームスコープのラベルも返すのかは確認されていません。ラベル解決はまずチーム自身のラベルを参照するため、チームのラベルは常に同名のワークスペースラベルより優先されます。

Linear スキーマの変更後に再検証するには:

LINEAR_API_KEY=lin_api_... .venv/bin/python scripts/probe_schema.py <team-key> <issue-number> <issue-uuid>

チームキー、そのチームの既存の課題番号、その課題の UUID が必要です(最初のプローブが出力するチーム UUID を対話的に 1 回だけ求めます)。プローブは読み取り専用です。ミューテーションは入力型のイントロスペクションによってチェックされ、トラッカーへの書き込みは行いません。

注意事項

  • Linear の個人用 API キーは Authorization: <key> として送信され、Bearer プレフィックスはありません。

  • Linear はほとんどの失敗を HTTP 200 とトップレベルの errors 配列で報告するため、クライアントはステータスコードではなくレスポンスボディをチェックします。

  • チーム、ステート、ラベル、ユーザーのメタデータはサーバープロセスの存続期間中キャッシュされます。チームのワークフローステートやラベルを変更した場合は、サーバーを再起動してください。

Available Tools

11 tools
add_commentA

Post a comment on a Linear issue. Markdown is supported. identifier: human issue identifier, e.g. "GOV-123".

Inputs: body (required), identifier (required).

create_issueA

Create a Linear issue. Returns the created issue including its new identifier. team: team key or name, e.g. "GOV". assignee: user display name or email. See list_users. state: workflow state name, e.g. "Backlog". See list_states. priority: 0 none, 1 urgent, 2 high, 3 medium, 4 low. labels: label names on that team. See list_labels.

Inputs: team (required), title (required), state, labels, +3 more.

get_commentsA

Fetch the comments on a Linear issue, oldest first. identifier: human issue identifier, e.g. "GOV-123".

Inputs: identifier (required). Returns: result

get_issueA

Fetch a Linear issue by its human identifier, e.g. "GOV-123". Returns title, description, state, assignee, team, priority, labels, URL, and the git branch name Linear suggests for the issue.

Inputs: identifier (required).

list_labelsA

List the issue labels that can be applied to an issue, as {name}. team: optional team key or full team name. With a team, returns that team's own labels followed by the workspace-wide labels; without one, the workspace-wide labels only. Names are what create_issue and update_issue accept for labels.

Inputs: team. Returns: result

list_my_issuesA

List issues assigned to the owner of the configured API key, most recently updated first. state: optional state-name filter, e.g. "In Progress". Case-insensitive. The filter is applied after the fetch, so passing one makes the server over-fetch (four times limit, at least 50 issues) and then cut the result back to limit. It is therefore best-effort within that window: a matching issue further down the list than the window reaches is not returned. Raise limit if you suspect one is missing. limit: maximum number of issues returned.

Inputs: limit, state. Returns: result

list_statesA

List the workflow states for a team, in workflow order, as {name, type}. These names are what create_issue and update_issue accept for state. team: team key or full team name.

Inputs: team (required). Returns: result

list_teamsA

List Linear teams as {key, name}. Team keys are the prefix of issue identifiers, e.g. the GOV in GOV-123.

Inputs: no named parameters. Returns: result

list_usersA

List active Linear users as {name, email}. name is the display name that create_issue and update_issue accept for assignee. query: optional case-insensitive substring filter over name and email.

Inputs: query. Returns: result

search_issuesA

Full-text search over Linear issues, with optional filters. team: team key or full team name, e.g. "GOV" or "Governance". state: workflow state name, e.g. "In Progress". Resolved against the team's workflow when team is given; without a team there is no workflow to resolve against, so the value is sent as written and must match the state name Linear stores. assignee: user display name, full name, or email. See list_users. Names are resolved the same way create_issue resolves them: a name that does not match returns an error listing the valid options, not an empty result.

Inputs: query (required), team, limit, state, +1 more. Returns: result

update_issueA

Update fields on an existing Linear issue. Only the fields you pass are changed. identifier: human issue identifier, e.g. "GOV-123". state, assignee, labels: names, resolved against the issue's own team. priority: 0 none, 1 urgent, 2 high, 3 medium, 4 low. Passing labels replaces the issue's labels entirely.

Inputs: identifier (required), state, title, labels, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 11 tools

    Disambiguation5/5

    Each tool targets a distinct resource or action: list_* clearly separates teams, states, labels, users, and my issues, while get_issue, search_issues, and list_my_issues offer different retrieval modes. Comments, creation, and updates are also cleanly separated with no overlapping responsibilities.

    Naming Consistency5/5

    The tools consistently follow a verb_noun snake_case pattern: list_teams, list_states, get_issue, create_issue, update_issue, add_comment, and so on. list_my_issues is a minor variation but still predictable and fits the overall naming logic.

    Tool Count5/5

    With 11 tools, the server is well-scoped for a Linear issue-management integration. It provides reference lookups, issue operations, and comments without redundant or unnecessary tools.

    Completeness4/5

    The core issue lifecycle is covered: create, get, update, search, list-my-issues, and comments, plus supporting lookups for teams, states, labels, and users. Obvious gaps like deleting/archiving issues or listing all issues in a team are minor and can often be worked around with search_issues.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers