# Notion

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: makenotion
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/makenotion/notion-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/makenotion-notion

## What it 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.

## Requirements
- Needs: Docker
- Works with: Notion

## Install

### Claude Code (native platform)

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

## When to use it
- 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
- 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

## Similar
- [notion-meeting-intelligence](https://affpapa.org/en/nevibecode/skills/notion-meeting-intelligence-2.md) — skill · 356 installs
- [easy-notion](https://affpapa.org/en/nevibecode/mcp/easy-notion.md) — MCP server · ★ 56 repo stars
- [better-notion-mcp](https://affpapa.org/en/nevibecode/mcp/n24q02m-better-notion-mcp.md) — MCP server · ★ 36 repo stars
- [WireCat notion](https://affpapa.org/en/nevibecode/mcp/wirecat-notion.md) — MCP server · ★ 1 repo stars
- [pp-notion](https://affpapa.org/en/nevibecode/skills/pp-notion.md) — skill · 394 installs
- [notion-sdk](https://affpapa.org/en/nevibecode/skills/notion-sdk.md) — skill · 133 installs

## Other versions with the same name
- [Notion · ](https://affpapa.org/en/nevibecode/mcp/notion.md) — 3841 installs
- [Notion · foreverworks](https://affpapa.org/en/nevibecode/mcp/foreverworks-notion.md) — ★ 5 repo stars
- [Notion · ](https://affpapa.org/en/nevibecode/mcp/docker-notion.md)

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
