# Connect Linear with Unblocked to trace issues to the code that shipped them URL: https://getunblocked.com/integrations/linear/ Unblocked integrates with Linear to give AI coding agents and developers cited context from your teams’ issues and projects — connected to the code, pull requests, and discussions behind them. --- ## Linear integration details - **Category:** Issue trackers - **Indexed data:** issues, teams - **Supported products:** Linear - **Works with:** Claude Code, Cursor, Windsurf, GitHub Copilot, Codex, VS Code — via one MCP server connection - **Content reviewed:** July 20, 2026 - **Documentation:** - **Website:** ## What the Linear integration adds 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. ## How to connect Linear to Unblocked 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. See the complete setup guide, screenshots, and troubleshooting: ### 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): ```bash curl -fsSL https://getunblocked.com/install-mcp.sh | bash ``` 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 Code — add the remote server, then run /mcp in Claude Code, select unblocked, and log in via OAuth: ```bash claude mcp add -s user --transport http unblocked https://getunblocked.com/api/mcpsse ``` Cursor — open View: Open MCP Settings → Add Custom MCP, add the server, then click Connect to authenticate via OAuth: ```json { "mcpServers": { "unblocked": { "url": "https://getunblocked.com/api/mcpsse" } } } ``` Any MCP-compatible client (Windsurf, Codex, VS Code, Claude Desktop, and others) can connect to the remote server with OAuth: `https://getunblocked.com/api/mcpsse` ## Connect Linear to Claude Code, Cursor, and other AI agents 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_research`** — Multi-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_urls`** — Fetches the full content behind a Linear issue URL your agent encounters — plus GitHub, Jira, Confluence, Notion, Slack, and more. - **`research_task`** — Investigates 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 to ask an AI agent about Linear 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?" ## Related integrations - [Jira](https://getunblocked.com/integrations/jira/) — Issues and projects from Jira Cloud and Data Center — with sprint-aware answers that connect tickets to the code and PRs behind them. - [Asana](https://getunblocked.com/integrations/asana/) — Projects, tasks, and comments from your Asana workspaces, surfaced as cited context with their project names attached. - [GitHub](https://getunblocked.com/integrations/github/) — Repositories, pull requests, issues, discussions, and full code history — indexed, kept in sync on every push, and cited in answers. - [Notion](https://getunblocked.com/integrations/notion/) — Pages from your Notion workspaces, indexed as cited sources so answers can draw on specs, wikis, and design docs. ## Get started with Unblocked - Start a free trial: - Pricing: - Documentation: - All integrations: