PluginInstalls cleanly
Plan and track issues in Linear by chat
Linear
Linear's plugin connects your assistant to Linear's hosted MCP server, so it can find, create and update issues, projects and comments for you.
- Works with
- Claude Code, Codex CLI
- Good for
- Build an app
What it does
Linear is an issue tracker for software teams. This plugin connects your assistant to Linear's hosted MCP server (https://mcp.linear.app/mcp), so it can find, create and update issues, projects and comments in your Linear workspace from the chat.
The plugin itself holds only that server address. It has no skills, commands or hooks. You sign in with your Linear account in the browser (OAuth); you do not need an API key.
It is handy when you vibe-code: ask the assistant to turn a plan into issues, pick the next issue, and mark it done when the work is finished.
Example prompts
- "Turn the plan in PLAN.md into a Linear project with one issue per step."
- "What are my open issues this cycle, sorted by priority?"
- "Create a bug issue for the login error we just fixed and mark it done."
- "Add a comment to ENG-123 with a summary of today's changes."
How to install
/plugin install linear@claude-plugins-officialHow to use it
Ask: Turn the plan in PLAN.md into a Linear project with one issue per step. Run /mcp and sign in to Linear the first time.
Check it works
In Claude Code, run /mcp. The server shows as plugin:linear:linear. Choose it and sign in in the browser. Then ask "List my assigned Linear issues" and you should see your own issues.
Common problems
- The tools are not connected — run
/mcpin Claude Code, chooseplugin:linear:linearand sign in — https://code.claude.com/docs/en/mcp - You want it to read but never change anything — turn the plugin off in the Installed tab of
/plugin, then add Linear's read-only endpoint:claude mcp add --transport http linear-server https://mcp.linear.app/mcp/readonly— https://linear.app/docs/mcp - You see an internal server error when you connect through
mcp-remote— runrm -rf ~/.mcp-auth, update Node.js and connect again — https://linear.app/docs/mcp - You use two Linear workspaces — each workspace needs its own sign-in; Linear's docs show how to keep them apart with
MCP_REMOTE_CONFIG_DIR— https://linear.app/docs/mcp - You hit the issue limit — the Free plan has 250 issues — https://linear.app/pricing
Other assistants
- Codex:
codex mcp add linear --url https://mcp.linear.app/mcp(Linear docs). Linear's docs say this prompts you to log in; if it does not, runcodex mcp login linear(Linear docs, OpenAI Codex MCP docs). Linear's docs still tell you to addexperimental_use_rmcp_client = trueunder[features]. You can skip that: current Codex (0.165.0) no longer knows this key, only logs a warning for it, and reads streamable HTTP servers without it. - Gemini CLI: Linear's docs have no Gemini CLI section, so there is no official Gemini CLI line. For other tools Linear gives a general route: command
npx, arguments-y mcp-remote https://mcp.linear.app/mcp, for clients that cannot use remote MCP servers.
What to watch out for
- The plugin connects to the read-write endpoint https://mcp.linear.app/mcp, so the assistant can create and change issues, projects and comments in your workspace; Linear's read-only endpoint https://mcp.linear.app/mcp/readonly is not what the plugin uses (external_plugins/linear/.mcp.json, Linear MCP docs)
- The plugin is only a pointer to Linear's hosted server (one .mcp.json and one plugin.json, no skills, commands or hooks); what the tools can do is set by Linear and can change without a plugin update (external_plugins/linear, Linear MCP docs)
- The Apache-2.0 licence covers Anthropic's directory repo, not Linear's server; Linear is a hosted service whose Free plan stops at 250 issues and 2 teams (repo LICENSE, linear.app/pricing)
Licence and author
- Licence
- Apache-2.0
- Author
- Linear
How we tested it
We installed it on an empty test computer on 28 Oct 2026. Installed and started in a clean test system. Not yet used in a real AI session.
Not yet used on real work.
Technical details of the test
- Date
- 28 Oct 2026
- Method
- Intake sandbox run on 2026-10-28 in a clean container with no account: cloned the repository and checked its skill, agent and plugin files; installed linear@claude-plugins-official with the Claude Code command line.
Checked again on 28 Oct 2026
Alternatives
- Atlassian MCP Server — the same idea for Jira and Confluence
- Airtable Skills — simple tables if you do not use an issue tracker
FAQ
- Q: Does it cost money? A: The plugin is free. Linear has a Free plan ($0, unlimited members, 2 teams, 250 issues), and its plan table lists MCP access on every plan, Free included. Basic is "$10 per user/month", "Billed yearly" (pricing page, checked 2026-10-28).
- Q: Can I stop it from changing things? A: Yes. Turn the plugin off and add the read-only endpoint https://mcp.linear.app/mcp/readonly yourself. Linear's docs also allow a read-only sign-in that asks only for the read scope.
- Q: Do I need an API key? A: No. Sign-in is OAuth in your browser. Linear's docs say you can also send an API key or OAuth token in an
Authorization: Bearerheader instead.
Sources
- github.com/anthropics/claude-plugins-official/tree/main/external_plugins/linear
- linear.app/docs/mcp
- linear.app/pricing
- developers.openai.com/codex/mcp