StackMCP

Set up Linear MCP in Windsurf

Manage Linear issues, projects, cycles, and teams. Create, update, and search issues directly from your AI editor.

1

Locate the config file

Windsurf reads MCP server configuration from the following file:

~/.codeium/windsurf/mcp_config.json

Create this file if it does not already exist.

2

Add the configuration

Add the following to your Windsurf 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_KEYRequired

Linear API key

4

Verify it works

Restart Windsurf. 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.

Set up Linear MCP in other editors