Linear MCP server (official)

Linear's official remote server for finding, creating and updating issues, projects, comments and documents. Authorize through OAuth; a read-only endpoint is also available.

Remote (HTTP)OAuth

Set up Linear

Configuration examples, not tested connections. Replace placeholders and review the upstream documentation before use.

Claude Code

Run in your terminal.

claude mcp add --transport http linear-official https://mcp.linear.app/mcp

Cursor

Merge into ~/.cursor/mcp.json

{
  "mcpServers": {
    "linear-official": {
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

Codex

Run in your terminal.

codex mcp add linear-official --url https://mcp.linear.app/mcp
codex mcp login linear-official

Gemini CLI

Merge into ~/.gemini/settings.json

{
  "mcpServers": {
    "linear-official": {
      "httpUrl": "https://mcp.linear.app/mcp"
    }
  }
}

OpenCode

Merge into ~/.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "linear-official": {
      "type": "remote",
      "url": "https://mcp.linear.app/mcp",
      "enabled": true
    }
  }
}

VS Code

Merge into .vscode/mcp.json

{
  "servers": {
    "linear-official": {
      "type": "http",
      "url": "https://mcp.linear.app/mcp"
    }
  }
}

Using more than one server?Add to a config with other servers

Step-by-step setup guides: Claude Code and Codex CLI, Cursor and VS Code. In Claude Desktop, add the URL as a custom connector. This is a remote server with OAuth sign-in; see remote vs local servers and authentication and security basics.

Overview

Linear hosts its own MCP server and documents it at linear.app/docs/mcp. It is the replacement that the deprecated community server, still listed here as linear, points its users to. The server follows the authenticated remote MCP specification and uses Streamable HTTP at https://mcp.linear.app/mcp.

The tools cover everyday work in Linear. list_issues and get_issue find and read issues, and save_issue creates or updates one, including its status, assignee and labels. list_projects, list_teams and related tools give the agent the structure of your workspace, and save_comment adds comments. Linear's documentation includes example prompts for planning a roadmap from a document, triaging bugs and writing updates.

Setup uses OAuth 2.1 with dynamic client registration. Add the URL, then approve access in the browser. In Claude Code use /mcp; in Codex, run codex mcp login linear-official after adding the server. Linear also accepts a bearer token or Linear API key, and supports enterprise-managed authentication. To keep an agent from changing anything, connect to https://mcp.linear.app/mcp/readonly, which only ever exposes read tools, or request only the read OAuth scope. For clients without remote support, Linear documents running it through npx -y mcp-remote.

Example tools

  • list_issues
  • get_issue
  • save_issue
  • list_projects
  • save_comment
  • list_teams

Tool names are upstream examples. The server's live tool list can differ.

Browse Productivity servers

Sources

This page was written from the upstream documentation below and last reviewed on 11 October 2026. Listing is not a security or compatibility endorsement. Report a correction through the contact page.