Official · remote server
Linear MCP server
Yes. Linear runs an official remote MCP server. You sign in with your Linear account in the browser, so there is no API key to paste.
- Maintained by
- Linear
- Sign-in
- Linear account no API key
- Tools
- 22 17 read · 5 write
- Community servers
- 4 by third parties in the MCP Registry
- Docs
- linear.app/docs/mcp
- Registry version
- 1.0.1
01Setup
How to connect the Linear MCP server
Every client below points at the same official URL. Pick yours.
Claude (web, desktop and mobile)
- 1 Click Add to Claude, or open Settings → Connectors → Browse connectors and search for Linear.
- 2 Click Connect. Sign in to Linear and approve the access it asks for.
- 3 In a chat, open the tools menu under the message box and check Linear is on.
Tool-by-tool permissions, security notes and reviews: Linear connector for Claude.
Claude Code
- 1 Run this in your terminal:Add
claude mcp add --transport http linear https://mcp.linear.app/mcp--scope userto use it in every project, or--scope projectto share it through.mcp.json. - 2
Start Claude Code, type
/mcp, pick linear and sign in to Linear in the browser. - 3
Check it with
claude mcp list.
Prefer a plugin? Linear also publishes a Linear plugin for Claude Code
, 48,038 installs on Anthropic’s plugin directory. Run /plugin, open Discover and search for Linear.
ChatGPT
Linear is in ChatGPT’s plugin directory, published by Linear Orbit, Inc , and it uses the same MCP server URL. Open it and click Connect , then sign in to Linear.
Linear in ChatGPTCursor
Add to Cursor One click if the app is installed, or add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project) , then check it under Settings → MCP.
{
"mcpServers": {
"linear": {
"url": "https://mcp.linear.app/mcp"
}
}
} VS Code
Add to VS Code One click if the app is installed, or add this to .vscode/mcp.json in your project , then start the server from the file or the MCP view. It is used by Copilot agent mode.
{
"servers": {
"linear": {
"type": "http",
"url": "https://mcp.linear.app/mcp"
}
}
} Windsurf
Add this to ~/.codeium/windsurf/mcp_config.json , then refresh the MCP list in Cascade.
{
"mcpServers": {
"linear": {
"serverUrl": "https://mcp.linear.app/mcp"
}
}
} Codex CLI
Add this to ~/.codex/config.toml , then restart Codex.
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp" - Where it runs
- On Linear’s side, at mcp.linear.app. Nothing is installed on your machine.
- Sign-in
- Each person signs in with their own Linear account in the browser. The client gets that account’s access, nothing more.
- Client only runs local servers?
- Bridge to the remote URL with mcp-remote:
npx mcp-remote https://mcp.linear.app/mcp
02Capabilities
What the Linear MCP server can do
Summarised from the 22 tools in Linear’s listing: what an AI client can read, and what it can change.
- Reads
- Issues, Projects, Comments, Documents, Issue statuses, Teams, Users, Cycles, Documentation, Issue labels
- Changes
- Create and update issues and projects; create comments.
- Deletes
- No delete tool is listed. None of the 22 tool names starts with delete, remove or archive.
Linear’s own one-liner: “Manage issues, projects & team workflows in Linear” (Claude directory listing)
Example prompts from the official listings
“Triage or update relevant issues for this task with clear next actions”
ChatGPT
“Create a Linear issue for this bug”
Claude Code plugin
“What are my assigned Linear issues?”
Claude Code plugin
“Update the status of issue ABC-123 to In Progress”
Claude Code plugin
“Search Linear for authentication issues”
Claude Code plugin
03Tools
Linear MCP tools
All 22 tools an AI client can call once connected: 17 read, 5 create or change.
get_issue list_issues list_my_issues create_issue update_issue get_project list_projects create_project update_project list_comments create_comment get_document list_documents get_issue_status list_issue_statuses get_team list_teams get_user list_users list_cycles search_documentation list_issue_labels Tool names from Linear’s listing in Claude’s connector directory, checked 2026-10-20. Read and write labels are our reading of each name’s verb. In Claude you can set each tool to ask before it runs.
04Servers
Official vs community Linear MCP servers
5 servers for Linear in the official MCP Registry. “Official” means the registry entry is tied to linear.app or Linear’s own GitHub account; community servers are built by anyone else.
- Official Linear v1.0.1
MCP server for Linear project management and issue tracking
- Runs
- Remote mcp.
linear. app - Registry
- app.
linear/ linear - Published
- Aug 2026
Config for this server
Claude Code
claude mcp add --transport http linear https://mcp.linear.app/mcpCursor, Windsurf, Claude Desktop (mcpServers)
{ "mcpServers": { "linear": { "url": "https://mcp.linear.app/mcp" } } } - Community Linear MCP by usefulapi v1.10.1
Search, read and create Linear issues, projects, teams and cycles.
- Runs
- Remote linear.
usefulapi. io - Registry
- io.
usefulapi/ linear - Published
- Oct 2026
- Source
- m190/usefulapi-mcp
Config for this server
Claude Code
claude mcp add --transport http linear https://linear.usefulapi.io/mcpCursor, Windsurf, Claude Desktop (mcpServers)
{ "mcpServers": { "linear": { "url": "https://linear.usefulapi.io/mcp" } } } - Community linear-mcp v1.1.0
Query the Linear GraphQL API: viewer, teams, issue search.
- Runs
- Local · npm @mrfentmen/
linear-mcp - Registry
- io.
github. mrfentmen/ linear-mcp - Published
- Oct 2026
- Source
- mrfentmen/premium-mcps
Config for this server
Claude Code
claude mcp add linear -- npx -y @mrfentmen/linear-mcpCursor, Windsurf, Claude Desktop (mcpServers)
{ "mcpServers": { "linear": { "command": "npx", "args": [ "-y", "@mrfentmen/linear-mcp" ] } } } - Community Linear v0.1.2
Linear MCP — wraps the Linear GraphQL API (OAuth)
- Runs
- Remote gateway.
pipeworx. io - Registry
- io.
github. pipeworx-io/ linear - Published
- Sep 2026
- Source
- pipeworx-io/mcp-linear
Config for this server
Claude Code
claude mcp add --transport http linear https://gateway.pipeworx.io/linear/mcpCursor, Windsurf, Claude Desktop (mcpServers)
{ "mcpServers": { "linear": { "url": "https://gateway.pipeworx.io/linear/mcp" } } } - Community Linear MCP (multi-workspace, PAT auth) v0.3.2
Multi-workspace Linear MCP — PAT auth, 57 tools + 3 prompts, substrate enforcement, drop-in.
- Runs
- Local · PyPI adelaidasofia-linear-mcp
- Registry
- io.
github. adelaidasofia/ linear-mcp - Published
- May 2026
- Source
- adelaidasofia/linear-mcp
Config for this server
Claude Code
claude mcp add linear -- uvx adelaidasofia-linear-mcpCursor, Windsurf, Claude Desktop (mcpServers)
{ "mcpServers": { "linear": { "command": "uvx", "args": [ "adelaidasofia-linear-mcp" ] } } }
05FAQ
Linear MCP questions
Is there an official Linear MCP server?
Yes. Linear runs an official remote MCP server at https://mcp.linear.app/mcp. You sign in with your Linear account in the browser; there is no API key to paste. It exposes 22 tools: 17 read and 5 write.
What is the Linear MCP server URL?
https://mcp.linear.app/mcp. It is a remote MCP server over streamable HTTP, hosted at mcp.linear.app. Paste it into any client that supports remote MCP servers.
How do I add the Linear MCP server to Claude Code?
Run: claude mcp add --transport http linear https://mcp.linear.app/mcp. Then start Claude Code, type /mcp, choose linear and sign in to Linear. Add --scope user to make it available in every project.
How do I use the Linear MCP server in Cursor or VS Code?
In Cursor, add it to ~/.cursor/mcp.json under "mcpServers" as {"linear": {"url": "https://mcp.linear.app/mcp"}}. In VS Code, add it to .vscode/mcp.json under "servers" with "type": "http" and the same URL. Both apps also accept the one-click install links on this page.
Does the Linear MCP server need an API key?
No key to copy. You sign in to your Linear account in the browser when you first connect, and the client acts with that account’s access.
What tools does the Linear MCP server have?
22 tools: list_comments, create_comment, list_cycles, get_document, list_documents, get_issue, list_issues, create_issue, update_issue, list_issue_statuses, get_issue_status, list_my_issues, list_issue_labels, list_projects, get_project, create_project, update_project, list_teams, get_team, list_users, get_user, search_documentation.
Does Linear work in ChatGPT?
Yes. Linear is in ChatGPT’s plugin directory, published by Linear Orbit, Inc.
Should I use an official or a community Linear MCP server?
Start with the official server: it is run by Linear (Linear Orbit, Inc.). The 4 community servers are built by third parties; remote ones route your data through their own hosts and local ones usually need an API key.
Sources: the official MCP Registry, Linear in Claude’s connector directory , Linear in ChatGPT’s plugin directory, checked October 20, 2026. Client config formats follow each client’s own docs. This site is independent and not affiliated with Linear, Anthropic or OpenAI. See also the Linear connector page for reviews.