Notion · notion — Claude Code MCP server: what it does, how to install
An MCP server linking your Notion workspace to AI agents: search documents, fetch Markdown, build databases with SQL DDL, and manage comments.
no license 3,841 installs updated 2025-08-25
claude mcp add --transport http notion https://notion.run.toolsWhat Notion does
This integration connects your workspace to the model via the remote endpoint https://notion.run.tools. The assistant runs semantic queries across internal records and synced external platforms like GitHub, Jira, or Slack. Page content is retrieved as enhanced Markdown through notion-fetch. User directories support cursor pagination.
Database administration relies on SQL DDL syntax. Specifically, notion-create-database accepts a CREATE TABLE definition to set up schemas, while notion-update-data-source modifies existing collections. Inspecting the target schema with fetch beforehand is necessary so property keys match database columns.
Cloning content with notion-duplicate-page happens asynchronously, meaning the duplicated record is not populated immediately. The integration also updates database views, moves nodes between parent containers, and exports comment trees formatted in XML.
What it helps with
- find workspace documents with semantic search
- define and build databases using SQL DDL
- retrieve and update page properties
- leave comments anchored to specific blocks
Example prompts for the agent
- Search Notion for database architecture notes updated last week
- Create a new page with meeting action items under the engineering root
- Duplicate the onboarding checklist and leave a comment on the first heading
How to install Notion
Platform CLI: remote server
claude mcp add --transport http notion https://notion.run.toolsPlatform CLI: remote server
codex mcp add notion --url https://notion.run.toolsConfig file
{
"mcpServers": {
"notion": {
"url": "https://notion.run.tools"
}
}
}Config file
{
"servers": {
"notion": {
"type": "http",
"url": "https://notion.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http notion https://notion.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Notion
How to install Notion in Claude Code?
Run claude mcp add --transport http notion https://notion.run.tools in your console. The HTTP tools will become available in your current environment.
What does the Notion MCP server do?
It lets your coding assistant read Markdown pages, search workspace entries, execute SQL DDL against databases, and leave comments.
Why is a duplicated page empty right after the call?
The notion-duplicate-page action is asynchronous. Notion finishes duplicating the block tree in the background, so the new page needs a moment to fill up.
Similar MCP servers
All MCP servers for Notes, tasks and projects →Notion by other authors comes first.