Set up Linear MCP in Claude Code
Manage Linear issues, projects, cycles, and teams. Create, update, and search issues directly from your AI editor.
1
Locate the config file
Claude Code reads MCP server configuration from the following file:
~/.claude.jsonCreate this file if it does not already exist.
2
Add the configuration
You can configure Linear MCP using the CLI command or by editing the config file directly.
Option A: CLI command
bash
claude mcp add linear-mcp -e LINEAR_API_KEY=YOUR_LINEAR_API_KEY -- npx -y linear-mcpOption B: Config file
json
{
"mcpServers": {
"linear-mcp": {
"command": "npx",
"args": [
"-y",
"linear-mcp"
],
"env": {
"LINEAR_API_KEY": "YOUR_LINEAR_API_KEY"
}
}
}
}3
Set up environment variables
Linear MCP requires the following environment variables:
LINEAR_API_KEYRequiredLinear API key
4
Verify it works
Restart Claude Code. Linear MCP should appear in your MCP server list with 10 tools available.
This server adds approximately 5,150 tokens to your context window for tool definitions.