ClaudeBeginner9 min readUpdated Jun 10, 2026

MCP + Notion: A Second-Brain Agent That Actually Retrieves

Wire the Notion MCP server into Claude Desktop and turn your workspace into an ask-anything second brain — with citations, not hallucinations.

mcpnotionclaudeproductivityrag

Download this template

Grab a structured copy of "MCP + Notion: A Second-Brain Agent That Actually Retrieves" as JSON (for programmatic import) or Markdown (for docs and README files). Both are licensed CC-BY-4.0 with attribution.

Overview

Second-brain apps promise search, then deliver keyword hits. This workflow gives Claude direct read access to your Notion workspace via MCP, so you can ask 'what did we decide about pricing in Q1?' and get an answer with links, not links you have to skim.

How it works

  1. Notion MCP server runs locally with a read-only integration token.
  2. Claude Desktop discovers the server and its tools on launch.
  3. You ask a question in natural language; Claude picks the right search tool and filters.
  4. Every answer cites the Notion page URL — no citation, no claim.
  5. You never grant write access — it's a read-only brain for a reason.

Benefits

  • Search that understands 'we decided' vs 'we discussed'.
  • Answers with citations you can verify in one click.
  • Zero data leaves your machine except the query and cited pages.

Use cases

  • Personal knowledge management across 5+ years of Notion pages.
  • Team wikis where nobody remembers where the SOP lives.
  • Consultants who need to recall past client decisions instantly.

Step-by-step guide

Step 1: Create a read-only Notion integration

Notion → Settings → Integrations → New. Grant read only. Share only the databases and pages you want the agent to see.

Step 2: Install the Notion MCP server

npm install -g @notionhq/notion-mcp-server. Add it to Claude Desktop's mcp.json with the integration token.

Step 3: Test with a boring query first

'What's on the agenda for tomorrow's standup?' — if this works, your permissions are right.

Step 4: Enforce the citation rule in a project prompt

'Never make claims without a Notion URL. If you can't find it, say so.' This is the single most important line.

Step 5: Add a saved-query workflow

For recurring questions ('what's this week's priority?'), save them as Claude Projects. One-click retrieval.

Example

Query: 'What did we decide about the enterprise pricing tier last quarter?' Response: 'Per the Pricing Review Q1 doc (linked), the team decided to launch at $2,500/mo minimum with a 12-month commit. The follow-up in Sales Sync 2026-03-14 confirmed the floor stays until Q3.'

FAQs

Related resources

Workflows, articles, and tools that pair with this build.