mcp-linear

mcp-linear

MCP.Pizza Chef: tacticlaunch

One hundred and ninety-five separate actions ship here, far more than most: reading and writing issues, comments, projects, cycles, milestones, roadmaps, documents, saved views, customer records, and notifications. Everything is switched on all the time, including forty-one actions that archive, delete, or remove things, and there is no look-but-don't-touch mode, so the assistant can retire a project or delete a comment on its own reading of your request. Sign in with a personal Linear key or the built-in login step.

Coding
Communication

Use This MCP server To

File a bug in the right team without leaving my chat Move a ticket to In Progress and assign it to someone Summarize what my team shipped this cycle Draft this week's project update from what Linear already knows Find every open issue blocking a milestone Leave a comment on a ticket asking for more detail

README

Linear App Icon

MCP Linear

A Model Context Protocol (MCP) server for the Linear GraphQL API, built for real project-management workflows — not just basic issue CRUD.

MCP Linear npm version

Features

MCP Linear bridges AI assistants and Linear by implementing the MCP protocol. With it you can:

  • Retrieve issues, projects, teams, cycles, milestones, roadmaps, customers, customer needs, and workspace/project/initiative/team/issue/release/cycle documents
  • Create and update issues, change status, assign, and comment
  • Manage projects, full diff-aware project and initiative update lifecycles, milestones, roadmaps, saved views, and favorites
  • Create and manage workspace webhooks, including updates and signing-secret rotation
  • Prepare OAuth app manifests and authorization URLs, issue scoped client-credentials tokens, or manage child OAuth apps when authenticated as a managing OAuth application
  • Work with templates, custom fields, and attachments
  • Work with customer records, customer statuses/tiers, and customer needs linked to issues or projects
  • Read notifications, subscriptions, sessions, audits, and integrations without leaving MCP
  • Inspect rate-limit and server health before running heavy planning sessions

See TOOLS.md for the full inventory.

MCP-native resources and prompts

The server exposes MCP resources and prompts in addition to tools, including:

  • Resources: linear://viewer, linear://organization, linear://teams, linear://projects, linear://project/{id}, linear://project/{id}/issues, linear://project/{id}/documents, linear://issue/{id}, linear://document/{id}, linear://roadmap/{id}, linear://milestone/{id}, linear://rate-limit
  • Prompts: summarize-project-status, draft-project-update, triage-issue, summarize-document

Example prompts

Once connected, you can use prompts like:

mcp-linear FAQ

Can it delete or archive things by mistake?
Yes, and this is the main thing to know. Forty-one of the one hundred and ninety-five actions archive, delete, or remove something, they are always available, nothing asks you to confirm, and there is no setting that limits it to reading. Connect it with an account whose access matches how much you trust it.
What credential does it need, and does it cost anything?
Either a personal Linear key you create under Settings, then Security and access, then Personal API Keys, or the sign-in step built into the tool. Both are free with your existing Linear account, and the connection inherits exactly the permissions that account already has.
Can I use this to file a bug without opening Linear?
Yes. Describe the problem and name the team, and it creates the issue, sets the status, assigns it, and adds a comment if you ask.
Which apps does it work in?
Claude Desktop, Cursor, and VS Code have documented setups, and it installs with a single command. Any other app that accepts a pasted server entry will work.
Does offering nearly two hundred actions cause problems?
It can. Some apps slow down, clutter up, or hit their own limits when a single connection offers this many choices, and there is no way to switch off the ones you do not want.
Can it really create and manage sign-in applications, as the description suggests?
Only partly, and the project says so itself. A personal key cannot create or manage those applications; the relevant action just prepares a setup link for an administrator to confirm. Full management needs a token belonging to a managing application.
How hard is setup?
Easy. One command installs it, then you paste a short block with your key into your app's settings, or run the sign-in step instead.
Is it actively maintained?
Yes. Both the code and the published package were updated in July 2026, at version 1.4.1, and it carries a permissive MIT licence.