linear / setup / windsurf
Setup guide

Set up Linear in Windsurf

officialstreamable_httpofficial

Linear's official hosted MCP server — create, triage, and update issues and projects from your agent, over OAuth.


01Configuration
{ "mcpServers": { "linear": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.linear.app/mcp" ] } } }

Remote server. This uses the mcp-remote bridge so Windsurf can reach the hosted endpoint. Add it to ~/.codeium/windsurf/mcp_config.json.


02Steps
  1. Make sure Windsurf is installed and up to date.
  2. Open ~/.codeium/windsurf/mcp_config.json and add the block above (merge into any existing mcpServers).
  3. Provide any required API keys/credentials as environment variables.
  4. Restart Windsurf and confirm Linear’s tools appear.

03Other runtimes

04Provenance
config_sourcegenerated from captured install method
last_checked
sourcesUser submissions [p7]

Next step

Want agents that act within guardrails? Apex is the live governed-agent product — paced, capped, and fully-logged actions with approvals before anything runs.

Explore Apex →

See also: server page · is it safe? · alternatives

Set up Linear MCP in Windsurf — MCPExplorer