MCP server Official

Linear MCP Server

Linear's hosted MCP server for finding, creating and updating issues, projects and comments.

Author
Linear
Works with
Any MCP client, Claude Code, Cursor, OpenAI Codex, Windsurf
Documented
Oct 2, 2026

What Linear MCP Server is

A centrally hosted remote MCP server for Linear data using Streamable HTTP at https://mcp.linear.app/mcp with OAuth 2.1, or a bearer token / API key. A read-only endpoint is also offered.

What it does

How Linear MCP Server plugs in: which agents run it and what it addsRUNS INYour agentAny MCP clientClaude CodeOpenAI CodexCursor4 hosts documentedMCP SERVER · OFFICIALLinear MCP ServerConnect the agent to tools, data…4 install steps1 permission noteWHAT IT ADDSWhat it doesFind, create and update issues, p…Read-only endpoint /mcp/readonlyOAuth 2.1 with dynamic client reg…Enterprise Okta-managed authoriza…agent → extension → new capability · from the official repository or docs
Where Linear MCP Server runs and what it adds, from its documentation
  • Find, create and update issues, projects and comments
  • Read-only endpoint /mcp/readonly
  • OAuth 2.1 with dynamic client registration
  • Enterprise Okta-managed authorization
  • Example prompts for planning and standup notes

When to use it

Good fit

  • Managing Linear work from Claude Code, Codex, Cursor or Windsurf
  • Read-only access for safer exploration

Not for

  • Clients without remote MCP: use the mcp-remote module
  • Expecting every Linear feature: README says more functionality is coming

How to install Linear MCP Server

You need: Linear account; Node.js for mcp-remote clients

  1. Claude Code: claude mcp add --transport http linear-server https://mcp.linear.app/mcp
  2. Run /mcp in Claude Code to authenticate
  3. Codex: codex mcp add linear --url https://mcp.linear.app/mcp
  4. Others: npx -y mcp-remote https://mcp.linear.app/mcp
Configuration example (from the official docs)
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.linear.app/mcp"
      ]
    }
  }
}

Permissions and security

What it can access

  • Linear data access per OAuth scope; read scope only for read-only

Security notes from the maintainers

  • Read-only token cannot reach write APIs

Review the source before granting an agent access to credentials or production systems. We document what the maintainers state; we do not audit code.

Limitations

  • Tool set is still growing

Tools it extends

No user reviews yet

AI coding IDE, formerly Windsurf, now Devin Desktop: manage local and cloud coding agents inside a full IDE.

Free stops at: Light quota for agent usage, resets daily and weekly, Limited model availability

Listed Not yet reviewed

Verified windsurf.com (opens Devin Desktop (formerly Windsurf) website in a new tab)

Frequently asked questions

How do I add Linear MCP to Claude Code?

Run claude mcp add --transport http linear-server https://mcp.linear.app/mcp, then /mcp to authenticate. source

Does Linear MCP have a read-only mode?

Yes, use /mcp/readonly or request only the read OAuth scope. source

What transport does Linear MCP use?

Streamable HTTP. source

Related guides

Sources and gaps

Not stated by the maintainers: No public GitHub repo; repo_url is the docs page; License not applicable; last_release date not visible in the checked README.

More extensions to look at