Linear GraphQL APIを介して、Issue、プロジェクト、チーム、ロードマップの取得や更新を行い、AIアシスタントによるプロジェクトワークフローの管理を可能にします。
別名 tacticlaunch/mcp-linear, @tacticlaunch/mcp-linear
- スター
- 151
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- —
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
Linear MCPとは
Linear GraphQL APIを介して、Issue、プロジェクト、チーム、ロードマップの取得や更新を行い、AIアシスタントによるプロジェクトワークフローの管理を可能にします。
プロジェクトのREADMEから生成された概要
Linear MCP server について
このサーバーは、プロダクトチームやエンジニアリングチームが、AIアシスタントから直接複雑なプロジェクトワークフローを管理できるようにします。Linear GraphQL APIに接続することで、基本的なIssue管理から、高度なロードマップやイニシアチブの計画まで、幅広いタスクに対して深い統合を提供します。ユーザーは、Issue、プロジェクト、チーム、サイクル、マイルストーン、ロードマップに加え、顧客レコードやドキュメントともやり取りできます。
開発者は、パーソナルAPIキーまたはOAuthアクセストークンを使用して、ローカルにサーバーをセットアップできます。ワークスペースのWebhook管理、署名シークレットのローテーション、OAuthアプリマニフェストの準備といった高度なワークフローもサポートしています。また、プロジェクトステータスの要約や更新ドラフトの作成など、コミュニケーションを効率化するための専用のMCPリソースやプロンプトも提供します。レート制限やサーバーのヘルス状態を確認することで、既存の開発環境内で大規模なプランニングセッションをスムーズに実行できます。
できること
- 1Issue管理の自動化AIに対して、特定のタスクの作成、割り当て、またはステータスの更新を指示できます。
- 2プロジェクトステータスレポートの生成組み込みのプロンプトを使用して、現在のプロジェクトデータに基づいた週次更新のドラフトを作成できます。
- 3開発者向けインテグレーションの管理Issueやコメントのイベントに対するWebhookのセットアップと維持が可能です。
- 4プロジェクトドキュメントの分析プロジェクト関連のドキュメントから重要な決定事項を取得し、要約します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Linear MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにLinear MCPをインストール
$ claude mcp add mcp-linear -- npx -y @tacticlaunch/mcp-linearCursorにLinear MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-linear": {
"command": "npx",
"args": [
"-y",
"@tacticlaunch/mcp-linear"
]
}
}
}VS CodeにLinear MCPをインストール
.vscode/mcp.json
{
"servers": {
"mcp-linear": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tacticlaunch/mcp-linear"
]
}
}
}VS Code CLIにLinear MCPをインストール
$ code --add-mcp '{"name":"mcp-linear","type":"stdio","command":"npx","args":["-y","@tacticlaunch/mcp-linear"]}'Claude DesktopにLinear MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"mcp-linear": {
"command": "npx",
"args": [
"-y",
"@tacticlaunch/mcp-linear"
]
}
}
}CodexにLinear MCPをインストール
$ codex mcp add mcp-linear -- npx -y @tacticlaunch/mcp-linearCodex config.tomlにLinear MCPをインストール
~/.codex/config.toml
[mcp_servers.mcp-linear] command = "npx" args = ["-y", "@tacticlaunch/mcp-linear"]
Gemini CLIにLinear MCPをインストール
$ gemini mcp add -s user mcp-linear npx -- -y @tacticlaunch/mcp-linearGemini settings.jsonにLinear MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"mcp-linear": {
"command": "npx",
"args": [
"-y",
"@tacticlaunch/mcp-linear"
]
}
}
}設定
LINEAR_API_TOKENLINEAR_OAUTH_ACCESS_TOKEN
| 名前 | 説明 | 種類 |
|---|---|---|
| LINEAR_API_TOKEN | — | |
| LINEAR_OAUTH_ACCESS_TOKEN | — |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし未チェック
README
GitHubで見るMCP Linear
A Model Context Protocol (MCP) server for the Linear GraphQL API, built for real project-management workflows — not just basic issue CRUD.
Features
MCP Linear bridges AI assistants and Linear by implementing the MCP protocol. With it you can:
- Retrieve issues, projects, teams, cycles, milestones, roadmaps, customers, customer needs, and workspace/project/initiative/team/issue/release/cycle documents
- Create and update issues, change status, assign, and comment
- Manage projects, full diff-aware project and initiative update lifecycles, milestones, roadmaps, saved views, and favorites
- Create and manage workspace webhooks, including updates and signing-secret rotation
- Prepare OAuth app manifests and authorization URLs, issue scoped client-credentials tokens, or manage child OAuth apps when authenticated as a managing OAuth application
- Work with templates, custom fields, and attachments
- Work with customer records, customer statuses/tiers, and customer needs linked to issues or projects
- Read notifications, subscriptions, sessions, audits, and integrations without leaving MCP
- Inspect rate-limit and server health before running heavy planning sessions
See TOOLS.md for the full inventory.
MCP-native resources and prompts
The server exposes MCP resources and prompts in addition to tools, including:
- Resources:
linear://viewer,linear://organization,linear://teams,linear://projects,linear://project/{id},linear://project/{id}/issues,linear://project/{id}/documents,linear://issue/{id},linear://document/{id},linear://roadmap/{id},linear://milestone/{id},linear://rate-limit - Prompts:
summarize-project-status,draft-project-update,triage-issue,summarize-document
Example prompts
Once connected, you can use prompts like:
- "Show me all my Linear issues"
- "Create a new issue titled 'Fix login bug' in the Frontend team"
- "Change the status of issue FE-123 to 'In Progress'"
- "Assign issue BE-456 to John Smith"
- "Show all open issues in this project grouped by milestone and cycle"
- "Draft a weekly project update from the current Linear state"
- "Find the newest documents related to a project and summarize the key decisions"
- "Show the pinned documents and links on this team's home page"
- "Create a document for ENG-123 with resource ordering metadata"
- "Get the latest project update diff and archive an outdated update"
- "Show customer needs for this project and mark the important ones"
- "Create an initiative update and hide the generated diff from the update body"
- "Prepare a private OAuth app for my GitHub issue pipeline with client credentials enabled"
- "Issue a narrowly scoped client-credentials token for that GitHub pipeline"
- "Create a webhook for Issue and Comment events, then rotate its signing secret"
Installation
Authentication
Personal API key (default)
- Log in to your Linear account at linear.app
- Click on your organization avatar (top-left corner)
- Select Settings
- Navigate to Security & access in the left sidebar
- Under Personal API Keys click New API Key
- Give your key a name (e.g.,
MCP Linear Integration) - Copy the generated API token and store it securely — you won't be able to see it again
Personal API keys support the normal Linear and workspace-webhook tools. They cannot call Linear's alpha managed-child-OAuth-application API because that API requires the caller itself to be an OAuth application. With a personal API key, linear_generateOAuthApplicationSetup still prepares an official manifest and pre-filled Linear setup URL for an administrator to confirm.
OAuth access token (managed OAuth applications)
To let MCP actually create and manage child OAuth applications, authenticate it with an access token belonging to a Linear OAuth application that is eligible to manage those child applications:
export LINEAR_OAUTH_ACCESS_TOKEN=YOUR_OAUTH_ACCESS_TOKEN
mcp-linear
Or pass --oauth-token YOUR_OAUTH_ACCESS_TOKEN. Explicit command-line credentials take precedence over environment variables; when both environment credential types are present, OAuth authentication is selected. See Linear's OAuth documentation and OAuth application manifests.
Each MCP server process uses one Linear credential. If the managing app token uses actor=app (which cannot receive admin) and you also need admin-scoped workspace-webhook tools, configure two MCP server entries: one with the managing OAuth token for child-app operations and one with a workspace administrator's personal API key for workspace webhooks. A user-actor OAuth token carrying admin can cover the webhook side instead.
OAuth scopes are selected when an authorization URL or client-credentials token is requested; they are not mutable fields on an OAuth application. The MCP validates current Linear scopes, prepares authorization URLs, and can issue app-actor tokens with linear_createOAuthClientCredentialsToken. For GitHub-hosted pipelines, enable the client_credentials grant and request the narrowest useful scope, such as issues:create.
Client-credentials tokens normally expire after 30 days and have no refresh token. Linear permits multiple active tokens only while they use the same scope set; requesting a different scope set revokes the application's existing app-actor tokens. The token tool therefore requires both confirmSecretExposure: true and confirmScopeChangeRisk: true.
Creating an OAuth app and rotating OAuth or webhook secrets returns one-time secret material through MCP. Those tools require confirmSecretExposure: true; move returned values directly into a secret manager such as GitHub Actions secrets and do not paste them into source control or logs.
Webhook URLs must be publicly reachable HTTPS endpoints. Validation rejects credentials in URLs and obvious loopback, private-network, link-local, and local-hostname destinations.
Installing via add-mcp (Recommended)
add-mcp installs the server into Claude Code, Cursor, Codex, VS Code, Claude Desktop, and many other MCP-aware agents with a single command:
npx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
Add -g to install globally instead of into the current project. See the add-mcp docs for the full agent list and flags.
Manual configuration
Add the following to your MCP settings file:
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "@tacticlaunch/mcp-linear"],
"env": {
"LINEAR_API_TOKEN": "<YOUR_TOKEN>"
}
}
}
}
Client-specific configuration locations
- Cursor:
~/.cursor/mcp.json - Claude Desktop:
~/Library/Application Support/Claude/claude_desktop_config.json - Claude VSCode Extension:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json - GoMCP:
~/.config/gomcp/config.yaml
Manual run
Prerequisites:
- Node.js (v20+)
- NPM or Yarn
- Linear personal API key or OAuth access token
# Install globally
npm install -g @tacticlaunch/mcp-linear
# Or clone and install locally
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear
npm install
npm link # Makes the package available globally
Running the server
Run the server with your Linear API token:
mcp-linear --token YOUR_LINEAR_API_TOKEN
Or with a managing OAuth application's access token:
mcp-linear --oauth-token YOUR_OAUTH_ACCESS_TOKEN
Or set the token in your environment and run without arguments:
export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear
Validation
The default validation path is:
npm test
npm run build
npm test runs Jest unit tests and an official MCP SDK smoke test against the built stdio server, covering tool, resource, and prompt registration plus host-compatible schema emission.
Development
See DEVELOPMENT.md for local development details.
Links
tacticlaunch/cursor-memory-bank — If you are a developer seeking to enhance your workflow with Cursor, consider giving it a try.
License
This project is licensed under the MIT License — see the LICENSE file for details.
Linear MCPのよくある質問
Linear MCPをClaude Codeに追加するには
ターミナルでclaude mcp add mcp-linear -- npx -y @tacticlaunch/mcp-linearを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Linear MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
OAuthで使用できますか?
はい、Linear OAuthアプリケーションに属するアクセストークンを使用して認証し、子OAuthアプリケーションを管理できます。
AIはどのようなプロジェクトデータにアクセスできますか?
このサーバーを使用すると、Issue、プロジェクト、チーム、サイクル、マイルストーン、ロードマップ、顧客、および各種ワークスペースドキュメントへのアクセスが可能です。