Connect Notion with Unblocked to give AI agents your specs and wikis

Notion pages commonly capture product intent, design exploration, and working agreements before those ideas reach code. Unblocked makes the selected page hierarchy available as cited evidence, so agents can test an implementation assumption against the written plan.

Notion context is reconciled with your code, pull requests, tickets, and chat, so an agent can pull the spec behind a feature rather than reverse-engineering intent from the code alone.

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

• Workspace pages as context — Unblocked indexes the Notion pages you select — specs, wikis, and design docs — and cites the page it used in its answers.
• Auto-indexed subpages — Select a parent page and Unblocked automatically indexes pages added under it in the future, so coverage keeps up with your workspace.
• Scoped access — Choose entire sections or individual pages, and update what Unblocked can see from Notion’s connection settings at any time.
• Cross-source synthesis — Notion pages are combined with your code, pull requests, Jira tickets, 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 Notion account with access to the workspace and pages you want to index.
• An MCP-compatible coding agent (Claude Code, Cursor, Windsurf, etc.) to use the context in your editor.

Step 1: Connect Notion to Unblocked

1. In Unblocked, go to Settings → Data Sources → Connect another data source, and under Documentation select Notion.
2. Sign in to Notion and select the workspace you want to use with Unblocked.
3. Choose the pages to index — selecting a parent page auto-indexes pages added under it later — and click Allow access.
4. You are returned to Unblocked, which begins using the selected pages to answer questions.

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 Notion context, connect Notion to Unblocked and add the single Unblocked MCP server to your agent.

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

• context_researchMulti-source research across your Notion pages, plus your code, pull requests, and other connected sources. Returns a synthesized answer with citations back to the Notion page it used.
• context_get_urlsFetches the full content behind a Notion page URL your agent encounters — plus GitHub, Jira, Linear, Confluence, Slack, and more.

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

• What does the product spec say about the new onboarding flow?
• Where is our engineering style guide in Notion?
• What decisions are captured in the latest planning doc?
• Which Notion page describes our release process?