MCP Linear

What is MCP Linear?

MCP Linear is a Model Context Protocol (MCP) server for the Linear GraphQL API. It bridges AI assistants and Linear, supporting real project-management workflows beyond basic issue CRUD.

How to use MCP Linear?

Obtain a Linear personal API token from your Linear account settings. Install via npx add-mcp @tacticlaunch/mcp-linear --env LINEAR_API_TOKEN=<YOUR_TOKEN> (recommended) or manually configure your MCP client with "command": "npx", "args": ["-y", "@tacticlaunch/mcp-linear"] and the token in env. Alternatively, install globally (npm install -g @tacticlaunch/mcp-linear) and run mcp-linear --token YOUR_LINEAR_API_TOKEN or with the LINEAR_API_TOKEN environment variable set.

Key features of MCP Linear

• Retrieve issues, projects, teams, cycles, milestones, roadmaps, and documents.
• Create, update, assign, comment, and change status of issues.
• Manage projects, initiatives, milestones, roadmaps, saved views, and favorites.
• Work with templates, custom fields, webhooks, and attachments.
• Access customer records, statuses, tiers, and linked needs.
• Read notifications, subscriptions, sessions, audits, and integrations.
• Inspect rate-limit and server health before heavy planning sessions.

Use cases of MCP Linear

• List all Linear issues and filter by team or status.
• Create a new issue and assign it to a specific team member.
• Change an issue’s status to “In Progress” or “Done”.
• Draft a weekly project update using current Linear state.
• Summarize the newest documents related to a project.
• View customer needs for a project and mark important ones.

FAQ from MCP Linear

What is MCP Linear?

MCP Linear is an MCP server that enables AI assistants to interact with the Linear project management platform via the Linear GraphQL API, providing tools, resources, and prompts for common workflows.

How do I get a Linear API token?

Log in to Linear, go to Settings → Security & access → Personal API Keys, create a new key, and copy the token immediately.

What are the prerequisites?

Node.js v18 or later, npm or yarn, and a valid Linear API token.

How can I run the server manually?

Run mcp-linear --token YOUR_LINEAR_API_TOKEN, or set the LINEAR_API_TOKEN environment variable and run mcp-linear without arguments.

Which MCP clients are supported?

The server works with any MCP‑compatible client, such as Claude Desktop, Claude VSCode Extension, Cursor, Codex, and GoMCP. Configuration file paths for common clients are provided in the README.