Integrations
Enables interaction with Linear's GraphQL API, allowing querying and mutation operations for project management data.
Provides tools for interacting with Linear's GraphQL API, enabling AI assistants to retrieve issues, projects, and teams data, create and update issues, change issue status, assign issues to team members, add comments, and create projects and teams.
MCP Linear
A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.
Features
MCP Linear bridges the gap between AI assistant and Linear (project management tool) by implementing the MCP protocol. This allows to:
- Retrieve issues, projects, teams, and other data from Linear
- Create and update issues
- Change issue status
- Assign issues to team members
- Add comments
- Create projects and teams
Example prompts
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"
- "Add a comment to issue UI-789: 'This needs to be fixed by Friday'"
Installation
Getting Your Linear API Token
To use MCP Linear, you'll need a Linear API token. Here's how to get one:
- Log in to your Linear account at linear.app
- Click on organization avatar (in the top-left corner)
- Select Settings
- Navigate to Security & access in the left sidebar
- Under Personal API Keys click New 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!
Installing via Smithery (Recommended)
- To install MCP Linear for Cursor:
- To install MCP Linear for Claude Desktop:
Manual Configuration
Add the following to your MCP settings file:
Client-Specific Configuration Locations
- 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
Manual run
Prerequisites
- Node.js (v18+)
- NPM or Yarn
- Linear API token
Running the Server
Run the server with your Linear API token:
Or set the token in your environment and run without arguments:
Available Tools
See TOOLS.md for a complete list of available tools and planned features.
Development
See DEVELOPMENT.md for more information on how to develop locally.
License
This project is licensed under the MIT License - see the LICENSE file for details.
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
MCP server that enables AI assistants to interact with Linear project management system through natural language, allowing users to retrieve, create, and update issues, projects, and teams.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityAn MCP server that lets AI assistants interact with your Lunchmoney data, enabling natural language queries about transactions, budgets, and spending patterns.Last updated -438TypeScriptMIT License
- -securityAlicense-qualityAn MCP server that analyzes codebases and generates contextual prompts, making it easier for AI assistants to understand and work with code repositories.Last updated -2PythonMIT License
- -securityFlicense-qualityAn MCP server that enables AI assistants to interact with the Plane project management platform, allowing them to manage workspaces, projects, issues, and comments through a structured API.Last updated -JavaScript
- AsecurityAlicenseAqualityAn MCP server that supercharges AI assistants with powerful tools for software development, enabling research, planning, code generation, and project scaffolding through natural language interaction.Last updated -116TypeScriptMIT License