Skip to content
MCP server

Notion Full MCP

Notion MCP server with deep page reads, block editing, snapshots and file uploads

Runs locallyStatus and history
Install
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-mcp

Add 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_)Required
  • NOTION_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.

How AIPoweredBot checks servers