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 GitHubWhat 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
Onboardingpage with the text indraft.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.