Set it up
- 1
Turn on Notion in your AI
In Claude: Settings → Connectors → Notion (or add https://mcp.notion.com/mcp). In ChatGPT: Settings → Apps & Connectors → Notion. Then ask Claude to work with your pages.
- 2
Add it to your app once
Copy the short config below into your app. It just tells your AI where to find Notion.
- 3
Just ask
Tell it what you want in plain words — no special commands.
For example, say
“Find my most recent Notion pages and summarize what I've been working on this week”
Need the exact config? Show it +
Add to your client
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_<your-integration-token>\", \"Notion-Version\": \"2022-06-28\"}"
}
}
}
}Paste into your client's MCP configuration file.
Quick skills
Copy one, paste it to your AI, watch it work.
Knowledge Base Q&A
“Find the engineering onboarding doc in Notion and tell me what tools a new hire needs to install”
Database Updates
“Add three new rows to the Content Ideas database with titles, and set status to Draft”
Auto-Generated Pages
“Create a new page in the Meetings database titled 'Product Sync Oct 15' with today's discussion summary”
In the wild
“notion mcp works for the chat but not code. now my workflow has docs I comment with others in notion, while the actual work and source of truth is in GitHub”
“I've been using gpt-oss-20b which would fit on your GPU and I've found useful for basic tasks like recipe creation and agentic tool usage (I use it with Notion MCP tools)”
“the best thing so far is to use Claude with the Notion MCP. My workflow would be to open claude's app and just use the voice tool to say something like "create me a note about blabla in my personal notes"”
Good to know
- · Requires a Notion integration token, and each page/database must be shared with the integration explicitly
- · Block-level editing is limited — complex layouts may not round-trip perfectly
- · Database property types matter — writing to a rollup or formula column will fail
When to use
- ✓ You use Notion as your primary knowledge base and want AI to read from it
- ✓ You need to create or update pages from conversation without leaving your editor
- ✓ You want to query Notion databases by filter, sort, or formula
- ✓ You're building a second-brain workflow where AI maintains notes for you
When not to use
- × You use Obsidian, Roam, or a local notes system (use obsidian-mcp instead)
- × You need to manipulate complex embedded blocks like synced databases with full fidelity
- × You need offline access — this requires the Notion API to be reachable
About
Imagine asking your AI: 'Add a new row to my tasks database with due date Friday' or 'Find all docs about the Q3 roadmap and summarize them' — and it edits your Notion workspace directly. This server connects your AI to Notion so it can search, read, create, and update pages, databases, and blocks.
The official Notion MCP server connects AI assistants to your Notion workspace. Search pages, create and update content, query databases, and manage your knowledge base — all through conversation.
Maintained by Notion with official API support. Ideal for teams using Notion as their primary knowledge management system.
Workflows That Use Notion MCP
Let Claude read the right channels, draft replies, and turn noise into one clear digest.
Pull your content calendar from Notion, draft posts in Claude, and create the Linear task to publish — without copy-paste.
Let Claude turn scattered notes into tracked issues and keep Notion, Linear, and Jira in sync.
Works With
Also Consider
FAQ
What does Notion MCP do? +
Imagine asking your AI: 'Add a new row to my tasks database with due date Friday' or 'Find all docs about the Q3 roadmap and summarize them' — and it edits your Notion workspace directly. This server connects your AI to Notion so it can search, read, create, and update pages, databases, and blocks.
Do I need to know how to code? +
No. Turn it on in your AI's settings and ask in plain English — no terminal, no coding.
When should I use Notion MCP? +
Reach for it when you need to: You use Notion as your primary knowledge base and want AI to read from it; You need to create or update pages from conversation without leaving your editor; You want to query Notion databases by filter, sort, or formula; You're building a second-brain workflow where AI maintains notes for you.
When should I avoid Notion MCP? +
Skip it when: You use Obsidian, Roam, or a local notes system (use obsidian-mcp instead); You need to manipulate complex embedded blocks like synced databases with full fidelity; You need offline access — this requires the Notion API to be reachable.
