NativeAIHub
Notion MCP Server

Notion MCP Server

Connect your AI agent to your Notion workspace. Search pages, create content, update databases, add comments, and organize your knowledge base from your terminal.

MCP Server·4 sections·1 min read
productivitycontent
Install Prompt

Paste this into Claude Code to set it up:

I want to add the Notion MCP Server to my Claude Code setup.

IMPORTANT: Never use Read/Edit tools on ~/.claude.json. Use jq via Bash instead.

Run this command to add the MCP server:
```bash
jq '.mcpServers["notion"] = {"type": "http", "url": "https://mcp.notion.com/mcp"}' ~/.claude.json > /tmp/claude-json-tmp && mv /tmp/claude-json-tmp ~/.claude.json
```

No API key or token is needed. Notion uses OAuth for authentication.

After adding, restart Claude Code. On first connection, your browser will open a Notion OAuth prompt. Grant access to the workspaces and pages you want the agent to reach. Once authorized, the connection persists across sessions.

01What It Does

Your entire knowledge base, accessible from conversation

If your team uses Notion for documentation, project management, or knowledge sharing, this server turns your AI agent into a Notion power user. It can read and write across your entire workspace without you ever opening the Notion app.
🔍
Search and ReadFind pages, databases, and content by keyword or title. Retrieve full page content by URL or ID.
✏️
Create and UpdateBuild structured pages with rich content, create databases with custom schemas, and update properties and body content.
🗂️
Organize and CollaborateMove pages between sections, duplicate templates, add comments, and manage workspace hierarchy.

02Real Scenarios

1

"Create a project brief for the new feature"

The agent creates a structured page with objectives, requirements, timeline, and stakeholders, placed in the correct project folder.

2

"Find all tasks assigned to me"

The agent queries your project database, filters by assignee, and returns a summary of open tasks with status and due dates.

3

"Update today's meeting notes"

The agent finds today's entry in your meeting notes database and appends discussion points, action items, and decisions.

4

"Summarize our auth system documentation"

The agent searches across your workspace for related pages, reads through them, and provides a consolidated summary.

03Setup

# Add to ~/.claude.json under mcpServers
"notion": {
  "type": "http",
  "url": "https://mcp.notion.com/mcp"
}
On first connection, your browser opens a Notion OAuth prompt. Grant access to the workspaces and pages you want the agent to reach. Once authorized, the connection persists across sessions.

04Works Well With

✅
Todoist MCPKeep actionable tasks in Todoist while storing documentation and project details in Notion. The agent links them together.
🔥
Firecrawl MCPResearch topics on the web, then save structured summaries and findings directly into Notion pages.
🐙
GitHub MCPPull PR summaries or issue updates from GitHub and log them in your Notion project tracker.