How do I set up the Linear MCP server?

Add the Linear server to your MCP config using the command: npx with the package linear-mcp-server. See the full config below.

What does the Linear MCP server do?

Create and manage Linear issues, projects, and cycles from your AI client.

Linear MCP Server — Config Template & Setup Guide

claude_desktop_config.json

{
  "mcpServers": {
    "server-linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

Variable	Required	Description
`LINEAR_API_KEY`	✓ Required	Linear personal API key from your account settings.

Setup Instructions

Ensure Node.js 18+ is installed on your system.
Copy the config block above into your claude_desktop_config.json file (typically at ~/.config/claude/claude_desktop_config.json on macOS/Linux or %APPDATA%\Claude\claude_desktop_config.json on Windows).
Set the LINEAR_API_KEY environment variable: Linear personal API key from your account settings.
Restart your AI client to apply the config.

claude_desktop_config.json

Environment Variables

Setup Instructions

Related Servers