# Connect Notion with Unblocked to give AI agents your specs and wikis URL: https://getunblocked.com/integrations/notion/ Unblocked integrates with Notion to give AI coding agents and developers cited context from your workspace pages — reconciled with your code, pull requests, and tickets. --- ## Notion integration details - **Category:** Knowledge - **Indexed data:** pages, workspaces - **Supported products:** Notion - **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 Notion integration adds 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. ## How to connect Notion to Unblocked 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. 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 Notion 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 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_research`** — Multi-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_urls`** — Fetches the full content behind a Notion page URL your agent encounters — plus GitHub, Jira, Linear, Confluence, Slack, and more. ## Questions to ask an AI agent about Notion 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?" ## Related integrations - [Confluence](https://getunblocked.com/integrations/confluence/) — Pages and blog posts from the Confluence spaces you select — including rendered macro content — indexed and cited in answers. - [Google Drive](https://getunblocked.com/integrations/google-drive/) — Google Docs, Sheets, Slides, text files, and PDFs from the files, folders, and shared drives you choose — searchable alongside code and engineering history. - [Linear](https://getunblocked.com/integrations/linear/) — Issues from the Linear teams you select, indexed so answers can trace a feature or bug from ticket to the code that shipped it. - [Microsoft SharePoint](https://getunblocked.com/integrations/microsoft-sharepoint/) — Documents and pages from the SharePoint sites you select, referenced in answers with links back to the source. ## Get started with Unblocked - Start a free trial: - Pricing: - Documentation: - All integrations: