Connect Linear with Unblocked to trace issues to the code that shipped them

Linear provides the planning layer around engineering work: issues explain the problem and projects group the initiative. Unblocked relates those records to code and pull requests so agents can trace an implementation back to its intended outcome.

Linear context is reconciled with your code, pull requests, and docs, so an agent can trace a feature or bug from the issue that requested it to the code that shipped it.

Once connected, any MCP-compatible coding agent — Claude Code, Cursor, Windsurf, GitHub Copilot, Codex — can pull this context through a single Unblocked MCP server connection.

What you get

• Issues and projects as context — Unblocked indexes the issues and projects from the teams you select and cites the issue it used.
• Feature and bug tracing — Linear issues are linked to the pull requests and code that address them, so agents can follow work from ticket to shipped change.
• Team-level scoping — Grant access to all teams or a specific subset to match how your workspace is organized.
• Cross-source synthesis — Linear issues are combined with your code, pull requests, docs, and Slack threads into a single knowledge graph.

Need screenshots or troubleshooting?This is a concise connection summary. Follow the complete setup guide ↗

Prerequisites

• An Unblocked account (free to start).
• A Linear account with access to the workspace and teams you want to index.
• An MCP-compatible coding agent (Claude Code, Cursor, Windsurf, etc.) to use the context in your editor.

Step 1: Connect Linear to Unblocked

1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Project management select Linear.
2. Sign in to Linear, confirm the correct workspace, and click Authorize Unblocked.
3. Select the teams to index (all teams recommended, or a specific subset).
4. Click Save Settings — Unblocked immediately begins including these Linear resources in its answers.

Step 2: Install the Unblocked MCP server

On macOS, one command auto-detects and configures your supported agents (Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, VS Code):

The install script supports macOS only. On Windows or Linux, add the server manually using the configuration below, or follow the manual install guide ↗.

claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse

{
  "mcpServers": {
    "unblocked": {
      "url": "https://getunblocked.com/api/mcpsse"
    }
  }
}

https://getunblocked.com/api/mcpsse

To give Claude Code, Cursor, GitHub Copilot, Codex, or another MCP-compatible AI coding agent access to Linear context, connect Linear to Unblocked and add the single Unblocked MCP server to your agent.

Unblocked acts as the MCP context layer for your Linear data, searching issues, teams alongside your other connected sources and returning cited results through these tools:

• context_researchMulti-source research across your Linear issues and projects, plus your code, pull requests, and other connected sources. Returns a synthesized answer with citations back to the Linear issue it used.
• context_get_urlsFetches the full content behind a Linear issue URL your agent encounters — plus GitHub, Jira, Confluence, Notion, Slack, and more.
• research_taskInvestigates a broader question across your Linear issues, code, pull requests, docs, and Slack together, synthesizing a research brief instead of a single citation — useful when you don’t know which issue to start from.

Questions you (or your agent) can ask Unblocked about your Linear data:

• Which Linear issue tracked the new onboarding flow, and what shipped?
• What is the scope of the current cycle for the platform team?
• What was decided on the rate-limiting issue?
• Which issues are blocking the next release?