Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http notion https://notion.run.tools
Open on GitHub

What 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.tools

Step 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.

Notion foreverworks Connect an AI agent to Notion to search pages, read their contents, and make workspace changes. Useful when you want to work with notes and databases from a chat. CX Codex +1 ★ 5repo stars Notion makenotion Self-hosted MCP server for the Notion API: 22 tools for search, pages and data sources. Notion now points to its hosted replacement. CX Codex +1 Notion docker Connects Notion workspaces to coding agents to manage projects, organize knowledge, and write technical documentation. CX Codex +1 notion-research-documentation makenotion notion-research-documentation — a skill for Claude Code and Codex that explores Notion workspaces and external sources. Generates cited briefs, comparisons, and research summaries saved directly to your workspace. CX Codex +1 390installs pp-notion Nikica Jokic pp-notion drives Notion from the terminal through CLI commands, syncs pages to local SQLite, and tracks recent edits. Useful for workspace audits and agent automation. CX Codex +1 394installs WireCat notion WireCatLabs WireCat notion — an MCP server for Claude Code and Codex gives agents access to Notion pages, local search, and page edits. It connects through a Notion profile. CX Codex +1 ★ 1repo stars easy-notion Grey-Iris easy-notion — an MCP server that hands your agent Notion pages as plain markdown. Useful when you read and edit pages instead of parsing raw JSON. CX Codex +1 ★ 56repo stars better-notion-mcp n24q02m The better-notion-mcp server lets an AI agent work with Notion pages, databases, blocks, and comments using Markdown. Use it when an agent needs to read or edit workspace content. CX Codex +1 ★ 36repo stars notion_integration vuralserhat86 The notion_integration skill guides Notion searches, meeting documents, research notes, and spec-to-task workflows. Use it when project knowledge and implementation planning live in a Notion workspace. CX Codex +1 1installs

More in the catalog

Project sponsors

Companies that keep this analytics open