Skip to content

Connect Linear to Cursor

Issue tracker for product teams. Its hosted MCP server lets agents find, create and update issues, projects and comments, so design tasks stay linked to the work.

MCP serverOfficialChecked 2026-11-16

Before you start

  • Cursor installed (see its MCP documentation (opens in a new tab)).
  • Linear is available on macOS, Windows, Linux and the web.
  • Your agent opens a Linear sign-in page the first time it connects. For read-only access, use https://mcp.linear.app/mcp/readonly instead.
  1. Step 1: Add Linear to Cursor

    Install in one click

    Opens Cursor and asks you to confirm the server.

    Or add it to the project

    Add this to .cursor/mcp.json, or to ~/.cursor/mcp.json to use it in every project.

    .cursor/mcp.json
    {
      "mcpServers": {
        "linear": {
          "url": "https://mcp.linear.app/mcp"
        }
      }
    }
    Good to know
    • Cursor opens a sign-in page the first time it connects.
  2. Step 2: Check it's connected

    Open Cursor Settings, find the MCP section and check the server is enabled with its tools listed.

  3. Step 3: Try a first request

    Ask Cursor something that only works with Linear connected:

    Say to Cursor
    Find the Linear issues assigned to me that mention design and list them by priority.

If it doesn't work

  • Project servers live in .cursor/mcp.json; servers for every project live in ~/.cursor/mcp.json.
  • After editing the file by hand, toggle the server off and on in settings, or restart Cursor.
  • The Output panel (MCP Logs) shows why a server failed to start.