Skip to content →

MCP server

Abstract image of a drive with Linear's logo and the words "Remote MCP server"

The Model Context Protocol (MCP) server provides a standardized interface that allows any compatible AI model or agent to access your Linear data in a simple and secure way.

Connect to our MCP server natively or by using the mcp-remote module in Cursor, Windsurf, and other clients.

Linear's MCP server follows the authenticated remote MCP spec, so the server is centrally hosted and managed. The Linear MCP server has tools available for finding, creating, and updating objects in Linear like issues, projects, and comments — with more functionality on the way, and feedback on its functionality is welcomed.

Setup Instructions⁠

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.

Claude⁠

  • Navigate to Settings in the sidebar on web or desktop
  • Scroll to Integrations at the bottom and click Add more
  • In the prompt enter:
    • Integration name: Linear
    • Integration URL: https://mcp.linear.app/sse
  • Make sure to enable the tools in any new chats

Cursor⁠

  1. CTRL/CMD Shift J to open Cursor Settings.
  2. Select MCP.
  3. Select Add new global MCP server.
  4. Add the following:
{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    }
  }
}

Visual Studio Code⁠

  1. CTRL/CMD P and search for MCP: Add Server.
  2. Select Command (stdio)
  3. Enter the following configuration, and hit enter.

npx mcp-remote https://mcp.linear.app/sse

  1. Enter the name Linear and hit enter.
  2. Activate the server using MCP: List Servers and selecting Linear, and selecting Start Server.

Windsurf⁠

  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/sse"]
    }
  }
}

Zed⁠

  1. CMD , to open Zed settings.
  2. Add the following:
{
  "context_servers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.linear.app/sse"]
    },
    "settings": {}
  }
}