MCP Linear

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

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 (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
• Nango configuration or Linear API token

Running the Server

Create a .env file with your Nango configuration:

Then run the server:

Or use the fallback method with a Linear API token:

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.

Links

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.