MCP Linear
An MCP server for Linear: issues, projects, cycles, milestones, documents and project updates via the GraphQL API
Install
npx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKENAdd -g to install globally.
This is third-party code. Review the repository files before installing.
What it does
The server connects the agent to Linear with a personal API key or an OAuth token. The agent reads issues, projects, teams, cycles, milestones, roadmaps and documents, creates and updates issues, changes status, assigns people and comments. It can draft project and initiative updates and work with templates, custom fields, customers and customer needs. Besides tools, it exposes MCP resources and ready prompts for project summaries and issue triage.
Who it is for. For product and engineering teams on Linear who plan and track work together with an agent.
Good fit when
- You need to draft a weekly project update
- You want to create or reassign issues from an agent chat
- You need open issues grouped by milestone and cycle
Not a fit when
- Linear's official MCP server covers your needs
- Your team does not use Linear
Example request
Show open issues in the Checkout project by milestone and draft a weekly updateLimitations
Requires a Linear personal API key or OAuth token. Some OAuth app management tools work only with an OAuth application token, and webhooks require admin rights. Not an official project; Linear runs its own hosted MCP server. Linear availability from Russia is not guaranteed.
How to disable. Remove the linear block from the MCP config and revoke the API key in Linear settings under Security & access.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| LINEAR_API_TOKEN required, secret | Linear personal API key unless an OAuth token is set. |
| LINEAR_OAUTH_ACCESS_TOKEN secret | OAuth application token for managing child apps. |
Security check
- Creates and changes issues, projects and webhooks in an external service
- Can issue tokens and rotate secrets
README in short
The README lists capabilities for issues, projects, documents, customers, webhooks and OAuth apps, with the full tool list in TOOLS.md. It describes two auth options: a personal key and a managing app's OAuth token. Installation is via add-mcp, a manual npx config or a global npm package. It exposes MCP resources and prompts and ships unit tests plus a smoke test on the official SDK. MIT licensed.
FAQ
Where do I get a key?
In Linear open Settings, Security & access and create a Personal API Key.
How does it differ from Linear's official server?
This one runs locally via npm and offers a wider tool set, including project updates, customers, webhooks and OAuth apps.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search