Skip to content →

Connect Windsurf to the Linear MCP server

Overview⁠

Windsurf is a next-generation AI IDE that keeps you “in flow” by letting agents reason over your entire project. Adding Linear’s MCP server makes Linear data available to those agents.

Setup instructions⁠

Select the Cascade plugins icon and scroll to find and install the Linear MCP server.

To configure manually, follow these steps:

  1. CTRL/CMD , to open Windsurf settings.
  2. Under Scroll to Cascade -> MCP servers
  3. Select Add Server -> Add custom server
  4. Add the following:
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/mcp"]
    }
  }
}

Remote MCP connections are still early and we’ve found that the connection may fail or require multiple attempts. If you experience issues, try restarting your client or disabling and re-enabling the Linear MCP server.

Build your own integration

Create your own integration with Linear’s API and submit it to the directory.