Linear MCP Server
A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.
[](https://www.npmjs.com/package/@emmett.deen/linear-mcp-server)
[](https://smithery.ai/server/@emmett-deen/linear-mcp-server)
Features
- Access to Linear's GraphQL API through MCP tools
- Authentication via Linear API key
- Retrieve and modify data related to users, teams, projects, and issues
- Create, update and comment on issues
- Add and remove labels
- Create projects
- Comprehensive documentation of available tools
Installation
Installing via Smithery (Recommended)
To install Linear MCP Server for Claude Desktop automatically via Smithery:
Manual Configuration
After installation, add the following to your MCP settings file:
Client-Specific Configuration Locations
- 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 Installation
- Clone the repository
- Install dependencies
- Build the project
- Create a `.env` file with your Linear API token
- Start the server
Available Tools
See [TOOLS.md](TOOLS.md) for a complete list of available tools and planned features.
Overview
Linear-MCP-Server bridges the gap between Claude (AI assistant) and Linear (project management tool) by implementing the MCP protocol. This allows Claude 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
The server uses Linear's GraphQL API and authenticates via user tokens (not OAuth) for simplicity.
Getting Started
Prerequisites
- Node.js (v18+)
- NPM or Yarn
- Linear API token
Installation
Running the Server
Run the server with your Linear API token:
Or set the token in your environment and run without arguments:
Using with Claude Desktop
To use this MCP server with Claude Desktop:
- Enable Developer Mode in Claude Desktop (from the menu bar)
- Go to Settings > Developer options
- Click "Add Server"
- Configure with the following settings: - **Name**: Linear MCP Server - **Type**: Local Process - **Command**: linear-mcp-server - **Arguments**: --token YOUR_LINEAR_API_TOKEN
Alternatively, manually edit the config file:
- Save the config
- Restart Claude Desktop (quit completely and reopen)
- You should now see Linear MCP Server available as a tool in Claude
Example Claude Prompts
Once connected to Claude Desktop, 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'"
Development
To develop locally:
Extending the Server
To add new tools to the server:
- Follow the implementation guide in the [TOOLS.md](./TOOLS.md) document
- Make sure to follow the established code structure in the `src/` directory
- Update the documentation to reflect your changes
Developing and Contributing
Setup Development Environment
- Clone the repository
- Install dependencies
- Start in development mode
Publishing to npm
To publish this package to npm:
- Update the version in package.json
- Build the project
- Make sure you've already logged in to npm
- Publish to npm
- For Smithery registry, you'll need to work with the Smithery team to get your server listed in their catalog.
License
This project is licensed under the MIT License - see the LICENSE file for details.