MCP Linear

<p align="center"> <img src="https://github.com/tacticlaunch/mcp-linear/blob/main/docs/linear-app-icon.png?raw=true" alt="Linear App Icon" width="250" height="250"> </p> # 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.  [](https://www.npmjs.com/package/@tacticlaunch/mcp-linear) [](https://smithery.ai/server/@tacticlaunch/mcp-linear) <a href="https://glama.ai/mcp/servers/@tacticlaunch/mcp-linear"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@tacticlaunch/mcp-linear/badge" /> </a> ## 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 ### Authentication MCP Linear now uses Nango for secure authentication. You'll need to configure the following environment variables: - `NANGO_CONNECTION_ID`: Your connection ID from Nango - `NANGO_INTEGRATION_ID`: Your integration ID from Nango - `NANGO_BASE_URL`: The base URL for Nango API (typically `https://api.nango.dev`) - `NANGO_SECRET_KEY`: Your secret key from Nango #### Fallback Authentication If Nango is not configured, the system will fall back to using a Linear API token passed via the `--token` command line argument. ### Installing via [Smithery](https://smithery.ai/server/@tacticlaunch/mcp-linear) (Recommended) - To install MCP Linear for Cursor: ```bash npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor ``` - To install MCP Linear for Claude Desktop: ```bash npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude ``` ### Manual Configuration Add the following to your MCP settings file: ```json { "mcpServers": { "linear": { "command": "npx", "args": ["-y", "@tacticlaunch/mcp-linear"], "env": { "NANGO_CONNECTION_ID": "your_connection_id", "NANGO_INTEGRATION_ID": "your_integration_id", "NANGO_BASE_URL": "https://api.nango.dev", "NANGO_SECRET_KEY": "your_secret_key" } } } } ``` #### 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 - Nango configuration or Linear API token ```bash # 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 ``` #### Running the Server Create a `.env` file with your Nango configuration: ```bash NANGO_CONNECTION_ID=your_connection_id NANGO_INTEGRATION_ID=your_integration_id NANGO_BASE_URL=https://api.nango.dev NANGO_SECRET_KEY=your_secret_key ``` Then run the server: ```bash mcp-linear ``` Or use the fallback method with a Linear API token: ```bash mcp-linear --token YOUR_LINEAR_API_TOKEN ``` ## Available Tools See [TOOLS.md](https://github.com/tacticlaunch/mcp-linear/blob/main/TOOLS.md) for a complete list of available tools and planned features. ## Development See [DEVELOPMENT.md](https://github.com/tacticlaunch/mcp-linear/blob/main/DEVELOPMENT.md) for more information on how to develop locally. ## Links [tacticlaunch/cursor-memory-bank](https://github.com/tacticlaunch/cursor-memory-bank) - If you are a developer seeking to enhance your workflow with Cursor, consider giving it a try. ## License This project is licensed under the MIT License - see the LICENSE file for details.