Linear MCP Server

Note: This is a custom implementation. For the official Cline Linear MCP server, see cline/linear-mcp.

A Model Context Protocol (MCP) server that provides tools for interacting with Linear’s API, enabling AI agents to manage issues, projects, and teams programmatically through the Linear platform.

Features

• Issue Management

  • Create new issues with customizable properties (title, description, team, assignee, priority, labels)
  • List issues with flexible filtering options (team, assignee, status)
  • Update existing issues (title, description, status, assignee, priority)

• Team Management

  • List all teams in the workspace
  • Access team details including ID, name, key, and description

• Project Management

  • List all projects with optional team filtering
  • View project details including name, description, state, and associated teams

Prerequisites

• Node.js (v16 or higher)
• A Linear account with API access
• Linear API key with appropriate permissions

Quick Start

1. Get your Linear API key from Linear’s Developer Settings

2. Run with your API key:

LINEAR_API_KEY=your-api-key npx @ibraheem4/linear-mcp

Or set it in your environment:

export LINEAR_API_KEY=your-api-key
npx @ibraheem4/linear-mcp

Development Setup

1. Clone the repository:

git clone [repository-url]
cd linear-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

Running with Inspector

For local development and debugging, you can use the MCP Inspector:

1. Install supergateway:

npm install -g supergateway

2. Use the included run.sh script:

chmod +x run.sh
LINEAR_API_KEY=your-api-key ./run.sh

3. Access the Inspector:
   • Open localhost:1337 in your browser
   • The Inspector connects via Server-Sent Events (SSE)
   • Test and debug tool calls through the Inspector interface

Configuration

Configure the MCP server in your settings file based on your client:

For Claude Desktop

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

For VS Code Extension (Cline)

Location: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/path/to/linear-mcp/build/index.js"],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}