This server enables AI assistants to interact with Linear project management systems via the Model Context Protocol (MCP). Key capabilities include:
- Retrieve data about users, organizations, teams, projects, issues, cycles, and labels
- Create, update, and manage issues, including changing status, priority, due dates, and estimates
- Create and update projects and teams
- Add comments to issues and view issue history
- Assign issues to team members and manage subscribers
- Handle issue relationships (blocks, blocked by, related, duplicates)
- Manage subtasks and issue hierarchies
- Search and filter issues using various criteria
- Archive, duplicate, and transfer issues between teams
- Add issues to cycles and projects
- Manage issue labels and workflow states
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.
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
- -securityFlicense-qualityA Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.Last updated -153TypeScript
- -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
- AsecurityFlicenseAqualityAn 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 -1148TypeScript
- AsecurityAlicenseAqualityA powerful MCP server that provides interactive user feedback and command execution capabilities for AI-assisted development, featuring a graphical interface with text and image support.Last updated -132PythonMIT License