mcp-linear
mcp-linear
Linear の課題操作を公開する MCP サーバー。スタンドアロンで動作し、組み込みの Claude Linear MCP への依存はありません。
課題は人間が読める識別子(GOV-123)で指定します。ステート、チーム、ラベル、担当者は名前で指定し、サーバーが Linear UUID に解決します。名前が一致しない場合は、有効な選択肢を列挙したエラーを返します。
ツール
ツール | 説明 |
| 識別子で課題を取得する |
| API キーの所有者に割り当てられた課題 |
| チーム/ステート/担当者フィルター付きの全文検索 |
| チームに課題を作成する |
| 既存の課題のフィールドを更新する |
| 課題のコメント |
| コメントを投稿する |
| チームのキーと名前 |
| チームのワークフローステート |
| チームのラベルとワークスペースラベル(チームは任意) |
| アクティブなユーザー |
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_KEYAPI キーを取得する: 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 toolsadd_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
Scored across 11 tools
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.
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.
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.
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
Related MCP Connectors
Search, read and create Linear issues, projects, teams and cycles.
Issues, projects, cycles, and roadmaps via the official Linear hosted MCP server.
Find and manage issues, projects, and documents in your Linear workspace.
Unofficial Linear MCP — wraps the Linear GraphQL API (OAuth)
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAllows LLMs to integrate with Linear's issue tracking system, enabling them to create, update, search, and comment on issues through the Linear API.-
- AlicenseBqualityDmaintenanceEnables interaction with Linear's API to manage issues, projects, and teams. Supports creating, updating, searching, and deleting issues, along with project management and team operations through API key authentication.13ISC
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to interact with Linear's issue tracking system, including creating, updating, searching issues, adding comments, and accessing resources via the Linear API.MIT
- FlicenseAqualityDmaintenanceEnables AI agents to search, create, update, and manage Linear issues through natural language, with support for teams, workflows, and comments.91-