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:

npx -y @smithery/cli install @tacticlaunch/mcp-linear --client cursor

• To install MCP Linear for Claude Desktop:

npx -y @smithery/cli install @tacticlaunch/mcp-linear --client claude

Manual Configuration

Add the following to your MCP settings file:

{
  "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

# 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:

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:

mcp-linear

Or use the fallback method with a Linear API token:

mcp-linear --token YOUR_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.