Skip to main content
MCP server CX Codex

Notion · makenotion — Claude Code MCP server: what it does, how to install

Self-hosted MCP server for the Notion API: 22 tools for search, pages and data sources. Notion now points to its hosted replacement.

no license updated 2026-10-29

Open on GitHub

What Notion does

The server wraps the Notion API in MCP tools: search across the workspace, page reads and edits, database work. Version 2.0.0 moved to data sources as the main abstraction, so the three old database tools are gone and database calls now take data_source_id instead of database_id. Clients pick up the new tool names when the server starts, no code change on your side.

Two tools handle page bodies as Markdown rather than block JSON: retrieve-page-markdown and update-page-markdown. They need API version 2026-03-11, which the server reads per operation from its OpenAPI spec. Set Notion-Version yourself in OPENAPI_MCP_HEADERS and your value wins for every tool.

Setup starts in Notion: create an internal integration, copy its token, then connect the pages it should reach through the Access tab. A read-only integration is possible if you tick only content reading under capabilities. Notion has stopped supporting this repository and sends people to its hosted Remote Notion MCP instead, while issues here go unread. For a new project the hosted server is the safer pick.

What it helps with

  • read a Notion page as Markdown instead of block JSON
  • rewrite a page body from an agent's draft
  • find a page or data source by keyword
  • create a data source and fill in its properties
  • move a page under a different parent

Example prompts for the agent

  • Find the Notion page with the planning notes and read it as Markdown
  • Replace the content of the Onboarding page with the text in draft.md
  • List the templates in the tasks data source

How to install Notion

Install

The MCP registry has no launch command for it: see the repository README

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 do I install the Notion MCP server in Claude Code?

Create an internal integration at https://www.notion.so/profile/integrations and copy its token. Connect the pages you need in the Access tab, then register the server in your MCP client config — the setup goes through npm.

What does the Notion MCP server do?

It exposes the Notion API as MCP tools: search, page reading and editing in Markdown, database operations via data sources. Version 2.0.0 ships 22 of them.

How is it different from Remote Notion MCP?

Remote Notion MCP is Notion's own hosted server with OAuth and semantic search. This repository is a local build that no longer gets support, and Notion asks people to move to the hosted one.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Notion by other authors comes first.

Notion notion An MCP server linking your Notion workspace to AI agents: search documents, fetch Markdown, build databases with SQL DDL, and manage comments. CX Codex +1 3,841installs 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 docker Connects Notion workspaces to coding agents to manage projects, organize knowledge, and write technical documentation. CX Codex +1 notion-meeting-intelligence makenotion notion-meeting-intelligence — a skill for Claude Code, Codex, and Cursor. Drafts meeting agendas, internal pre-reads, and decision summaries using contextual workspace data from Notion. CX Codex +1 356installs 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 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 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 notion-sdk terrylica notion-sdk — a skill for managing Notion via the official Python SDK. Creates pages and databases, queries information, adds content blocks — all programmatically. CX Codex +1 133installs

Project sponsors

Companies that keep this analytics open