Notion Full MCP
Notion MCP server with deep page reads, block editing, snapshots and file uploads
- Pricing
- Open source
- Platforms
- CLI, self-hosted, Linux
- Runs
- Locally
- Version
- 0.5.1
- Listing updated
- today
Similar MCP servers
About Notion Full MCP
Notion Full MCP is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
This Python server covers more of the Notion API than a basic page reader. It reads a page with all nested children, edits single blocks (including find and replace that keeps formatting), inserts or appends blocks, edits table rows and cells, and uploads images and PDFs into Notion's own storage. Its 33 tools each declare whether they are read-only, additive or destructive, so clients can decide what to run without asking.
Snapshots are the safety net. snapshot_page saves a page as JSON, optionally with its hosted files, and restore_page_from_snapshot writes first and removes old blocks only afterwards, rolling back if it fails. Subpages and inline databases stay in place, and items deleted since the snapshot come back from trash.
Pages can be moved with their ID and comments intact, copied to another parent, or restored from trash. Large inputs are split across requests and rate limits are retried. It needs a Notion integration token in NOTION_API_TOKEN; NOTION_MCP_FILE_ROOT confines uploads, downloads and snapshots to one directory. Install from PyPI with pip or run with uvx.
Install
Run in a terminal
claude mcp add notion-full-mcp --env NOTION_API_TOKEN='<NOTION_API_TOKEN>' -- uvx notion-full-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"notion-full-mcp": {
"command": "uvx",
"args": [
"notion-full-mcp"
],
"env": {
"NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"notion-full-mcp": {
"command": "uvx",
"args": [
"notion-full-mcp"
],
"env": {
"NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"notion-full-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"notion-full-mcp"
],
"env": {
"NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"notion-full-mcp": {
"command": "uvx",
"args": [
"notion-full-mcp"
],
"env": {
"NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"notion-full-mcp": {
"command": "uvx",
"args": [
"notion-full-mcp"
],
"env": {
"NOTION_API_TOKEN": "<NOTION_API_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
NOTION_API_TOKENYour Notion integration API token (starts with ntn_)RequiredNOTION_MCP_FILE_ROOTOptional directory that uploads, downloads and snapshots are confined to
Tools this server provides (32)
Taken from the project documentation; the running server may differ.
- search_pages
- Search pages by title.
- search
- Search pages and/or databases.
- get_page_info
- Get page metadata such as title, parent, dates and URL.
- create_page
- Create a page under a parent page or database.
- update_page
- Update a page's title, icon or archive status.
- move_page
- Move a page under a new parent, keeping its ID and content.
- restore_page
- Restore a page and its cascade-archived children from trash.
- copy_page_to_parent
- Recreate a page under a new parent; archives the original only when every block was copied.
- read_page_deep
- Read a page with all nested children.
- list_block_children
- List direct children of a block or page.
- get_block
- Get a single block by ID.
- update_block_text
- Replace all text in a block.
- find_replace_in_block
- Find and replace text while preserving formatting.
- update_block_rich_text
- Update a block with a full rich text specification.
- insert_text_after
- Insert a text block after a given block.
- insert_blocks_after
- Insert multiple blocks after a given block.
- append_blocks_to_page
- Append blocks to the end of a page.
- delete_block
- Delete a block by ID.
- create_comment
- Add a comment to a page.
- list_comments
- List comments on a page or block.
- get_database
- Get database metadata and schema.
- query_database
- Query a database with filters and sorts.
- get_self
- Get the current authenticated user or bot.
- list_users
- List workspace users.
- snapshot_page
- Save a page's structure as JSON, optionally with hosted files.
- restore_page_from_snapshot
- Restore page content from a snapshot, rolling back on failure.
- upload_file
- Upload a file to Notion's workspace storage.
- upload_image_as_block
- Upload an image and insert it as an image block.
- replace_image_block
- Replace an image block's file while keeping its position.
- download_image_block
- Download the image file from an image block to disk.
- insert_table_row
- Add a row to an existing table.
- update_table_cell
- Replace the text of a single table cell.
What it does
- Deep page reading
- Reads a page with every nested child block in one call.
- Surgical block editing
- Updates text, rich text or find-and-replace within a block.
- Safe snapshot and restore
- Writes before deleting and rolls back if a restore fails.
- File and image uploads
- Uploads PNG, JPEG, SVG, GIF, PDF and other files to Notion storage.
- Table row edits
- Inserts rows and updates single cells without rebuilding the table.
- Move, copy and restore pages
- Moves pages keeping their ID, copies across parents, restores from trash.
- Tool annotations
- Each tool is marked read-only, additive or destructive.
- File boundary option
- Confines file operations to a chosen directory.
Good for
- Back up a Notion page before a risky edit
- Fix wording across a long page without losing formatting
- Replace an outdated screenshot while keeping its position
- Move a page to a new parent without breaking links
- Add rows to a table programmatically
Pricing
Open source
Notion Full MCP FAQ
What credentials does it need?
A Notion integration API token (starting with ntn_) in NOTION_API_TOKEN.
How do I install it?
Run pip install notion-full-mcp or uv pip install notion-full-mcp, or start it with uvx in your MCP config.
Can a failed restore lose content?
No. Restore writes the snapshot first, removes old blocks only after that succeeds, and rolls back on failure.
How many tools does it have?
33, covering search, pages, reading, editing, inserting, deleting, comments, databases, users, snapshots and files.
Can it limit where files are written?
Yes. Set NOTION_MCP_FILE_ROOT to confine uploads, downloads and snapshots to one directory.
Is Notion Full MCP free?
Yes. Notion Full MCP is open source, so you can use and self-host it for free.
How do I add Notion Full MCP to Claude Code?
Run this command in your terminal: claude mcp add notion-full-mcp --env NOTION_API_TOKEN='<NOTION_API_TOKEN>' -- uvx notion-full-mcp
What are the best alternatives to Notion Full MCP?
The closest alternatives to Notion Full MCP are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Concord MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



