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

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

Once connected, you can use prompts like:

- "Show me all my Linear issues"
- "Create a new issue titled 'Fix login bug' in the Frontend team"
- "Change the status of issue FE-123 to 'In Progress'"
- "Assign issue BE-456 to John Smith"
- "Show all open issues in this project grouped by milestone and cycle"
- "Draft a weekly project update from the current Linear state"
- "Find the newest documents related to a project and summarize the key decisions"
- "Show the pinned documents and links on this team's home page"
- "Create a document for ENG-123 with resource ordering metadata"
- "Get the latest project update diff and archive an outdated update"
- "Show customer needs for this project and mark the important ones"
- "Create an initiative update and hide the generated diff from the update body"
- "Prepare a private OAuth app for my GitHub issue pipeline with client credentials enabled"
- "Issue a narrowly scoped client-credentials token for that GitHub pipeline"
- "Create a webhook for Issue and Comment events, then rotate its signing secret"
- Log in to your Linear account atlinear.app
- Click on your organization avatar (top-left corner)
- SelectSettings
- Navigate toSecurity & accessin the left sidebar
- UnderPersonal API KeysclickNew API Key
- Give your key a name (e.g.,MCP Linear Integration)
- Copy the generated API token and store it securely — you won't be able to see it again

export LINEAR_OAUTH_ACCESS_TOKEN=YOUR_OAUTH_ACCESS_TOKEN mcp-linear

Or pass--oauth-token YOUR_OAUTH_ACCESS_TOKEN. Explicit command-line credentials take precedence over environment variables; when both environment credential types are present, OAuth authentication is selected. See Linear'sOAuth documentationandOAuth application manifests.

npx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN

Add-gto install globally instead of into the current project. See theadd-mcp docsfor the full agent list and flags.

{ "mcpServers": { "linear": { "command": "npx", "args": ["-y", "@tacticlaunch/mcp-linear"], "env": { "LINEAR_API_TOKEN": "<YOUR_TOKEN>" } } } }

- Cursor:~/.cursor/mcp.json
- Claude Desktop:~/Library/Application Support/Claude/claude_desktop_config.json
- Claude VSCode Extension:~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
- GoMCP:~/.config/gomcp/config.yaml

- Node.js (v20+)
- NPM or Yarn
- Linear personal API key or OAuth access token

# Install globally npm install -g @tacticlaunch/mcp-linear # Or clone and install locally git clone https://github.com/tacticlaunch/mcp-linear.git cd mcp-linear npm install npm link # Makes the package available globally

Run the server with your Linear API token:

mcp-linear --token YOUR_LINEAR_API_TOKEN

Or with a managing OAuth application's access token:

mcp-linear --oauth-token YOUR_OAUTH_ACCESS_TOKEN

Or set the token in your environment and run without arguments:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN mcp-linear

npm testruns Jest unit tests and an official MCP SDK smoke test against the built stdio server, covering tool, resource, and prompt registration plus host-compatible schema emission.

SeeDEVELOPMENT.mdfor local development details.

tacticlaunch/cursor-memory-bank— If you are a developer seeking to enhance your workflow with Cursor, consider giving it a try.

This project is licensed under the MIT License — see theLICENSEfile for details.

Excel manipulation including data reading/writing, worksheet management, formatting, charts, and pivot table