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-official

How 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 /mcp in Claude Code, choose plugin:linear:linear and 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 — run rm -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, run codex mcp login linear (Linear docs, OpenAI Codex MCP docs). Linear's docs still tell you to add experimental_use_rmcp_client = true under [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
Source code
github.com/anthropics/claude-plugins-official

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.

Test level

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: Bearer header instead.

Sources