Cette page est affichée en anglais. Une traduction française est en cours.
MCP ConfigsMay 8, 2026·5 min de lecture

Linear MCP — Project Management for Claude Code & Cursor

Linear's official MCP lets Claude Code, Cursor, Codex CLI manage Linear issues, projects, cycles. Search by status, create issues from chat, link PRs.

Linear
Linear · Community
Prêt pour agents

Staging sûr pour cet actif

Cet actif est d'abord staged. Le prompt copié demande à l'agent d'inspecter les fichiers staged avant d'activer scripts, config MCP ou config globale.

Stage only · 17/100Policy : staging
Surface agent
Tout agent MCP/CLI
Type
Mcp Config
Installation
Stage only
Confiance
Confiance : Community
Point d'entrée
Asset
Commande de staging sûr
npx -y tokrepo@latest install ed6f4647-de3c-4b1d-bf90-5f19903641c6 --target codex

Stage les fichiers d'abord; l'activation exige la revue du README et du plan staged.

Introduction

Linear's official MCP server exposes Linear's API as Model Context Protocol tools — search issues, create / update / comment, manage cycles and projects, link GitHub PRs. Configure once, every MCP-aware host (Claude Code, Cursor, Codex CLI, Cline) can manage your Linear workspace. Best for: engineering teams who want to triage / create / update Linear issues without leaving their AI coding tool. Works with: any MCP host. Setup time: 3 minutes.


MCP config

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

The first time you use a Linear tool, your browser opens to authorize the MCP via Linear OAuth. Token is stored locally.

Tools exposed

Tool Use
linear_list_issues Filter by status, assignee, project, labels
linear_get_issue Full issue with comments, attachments, history
linear_create_issue Create with team, priority, assignee, labels
linear_update_issue Change status, assignee, body
linear_create_comment Comment on issue or PR-linked issue
linear_list_projects Projects with progress, due dates
linear_list_cycles Active and upcoming cycles
linear_search Full-text search across issues

Common prompts

> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."

Auth and rate limits

  • OAuth token has the same scopes as your Linear account — read what you can read, write what you can write
  • Rate limit: 1,000 requests/hour per user (Linear's standard API limit)
  • For team-shared usage, generate a Linear personal API key with restricted scopes via Settings → API instead of OAuth

FAQ

Q: Is Linear MCP free? A: Yes — the MCP server is free and official. You only need a Linear account (Linear has a free tier for ≤10 users). The MCP wraps Linear's existing API; it doesn't add billing.

Q: Does this support Linear's webhooks? A: No — webhooks are server-to-server. Linear MCP is for client-driven actions (your AI agent reading and writing). For event-driven workflows, set up Linear webhooks separately and route them into Inngest / Trigger.dev.

Q: Can my agent only see issues I have access to? A: Yes — OAuth scopes match your account. The MCP cannot escalate to issues outside your visibility. For finer-grained control, generate a scoped API key via Linear's settings.


Quick Use

  1. Add the JSON snippet below to your MCP config (~/.claude/mcp.json or equivalent)
  2. Restart your MCP host
  3. First Linear tool call triggers OAuth — authorize in browser, token cached locally

Intro

Linear's official MCP server exposes Linear's API as Model Context Protocol tools — search issues, create / update / comment, manage cycles and projects, link GitHub PRs. Configure once, every MCP-aware host (Claude Code, Cursor, Codex CLI, Cline) can manage your Linear workspace. Best for: engineering teams who want to triage / create / update Linear issues without leaving their AI coding tool. Works with: any MCP host. Setup time: 3 minutes.


MCP config

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

The first time you use a Linear tool, your browser opens to authorize the MCP via Linear OAuth. Token is stored locally.

Tools exposed

Tool Use
linear_list_issues Filter by status, assignee, project, labels
linear_get_issue Full issue with comments, attachments, history
linear_create_issue Create with team, priority, assignee, labels
linear_update_issue Change status, assignee, body
linear_create_comment Comment on issue or PR-linked issue
linear_list_projects Projects with progress, due dates
linear_list_cycles Active and upcoming cycles
linear_search Full-text search across issues

Common prompts

> Show me all P0 issues assigned to me, sorted by created date

> Create a Linear issue: "Auth flow drops state on redirect" in #web team,
  priority urgent, assign to @me, attach the failing test from this file

> Comment on ENG-1234: "Reproduced — root cause is missing CSRF token. PR up tonight."

Auth and rate limits

  • OAuth token has the same scopes as your Linear account — read what you can read, write what you can write
  • Rate limit: 1,000 requests/hour per user (Linear's standard API limit)
  • For team-shared usage, generate a Linear personal API key with restricted scopes via Settings → API instead of OAuth

FAQ

Q: Is Linear MCP free? A: Yes — the MCP server is free and official. You only need a Linear account (Linear has a free tier for ≤10 users). The MCP wraps Linear's existing API; it doesn't add billing.

Q: Does this support Linear's webhooks? A: No — webhooks are server-to-server. Linear MCP is for client-driven actions (your AI agent reading and writing). For event-driven workflows, set up Linear webhooks separately and route them into Inngest / Trigger.dev.

Q: Can my agent only see issues I have access to? A: Yes — OAuth scopes match your account. The MCP cannot escalate to issues outside your visibility. For finer-grained control, generate a scoped API key via Linear's settings.


Source & Thanks

Built by Linear. Commercial product with free tier.

linear.app/docs/mcp — Official MCP documentation

🙏

Source et remerciements

Built by Linear. Commercial product with free tier.

linear.app/docs/mcp — Official MCP documentation

Fil de discussion

Connectez-vous pour rejoindre la discussion.
Aucun commentaire pour l'instant. Soyez le premier à partager votre avis.

Actifs similaires