cphoskins avatar

Notion Full Mcp

cphoskins/notion-full-mcp

Notion MCP server: deep reads, block editing, safe snapshot/restore, file uploads, page move/copy

tools
33
auth
Secret needed
transport
STDIO
env vars
2
last updated
Nov 11, 2026

Tools

33 tools

Public tool metadata for what this MCP can expose to an agent.

search_pagesSearch pages by title

Search pages by title

No parameter schema in public metadata yet.

searchSearch pages and/or databases

Search pages and/or databases

No parameter schema in public metadata yet.

get_page_infoGet page metadata (title, parent, dates, URL)

Get page metadata (title, parent, dates, URL)

No parameter schema in public metadata yet.

create_pageCreate a new page under a parent page or database

Create a new page under a parent page or database

No parameter schema in public metadata yet.

update_pageUpdate a page's title, icon, or archive status

Update a page's title, icon, or archive status

No parameter schema in public metadata yet.

move_pageMove a page under a new parent page, keeping its ID and content

Move a page under a new parent page, keeping its ID and content

No parameter schema in public metadata yet.

restore_pageRestore a page (and its cascade-archived children) from trash

Restore a page (and its cascade-archived children) from trash

No parameter schema in public metadata yet.

copy_page_to_parentRecreate a page under a new parent page or database. Archives the original only when every block was copied

Recreate a page under a new parent page or database. Archives the original only when every block was copied

No parameter schema in public metadata yet.

read_page_deepRead page with all nested children (recursive)

Read page with all nested children (recursive)

No parameter schema in public metadata yet.

list_block_childrenList direct children of a block or page

List direct children of a block or page

No parameter schema in public metadata yet.

get_blockGet a single block by ID

Get a single block by ID

No parameter schema in public metadata yet.

update_block_textReplace all text in a block

Replace all text in a block

No parameter schema in public metadata yet.

find_replace_in_blockFind/replace text preserving formatting

Find/replace text preserving formatting

No parameter schema in public metadata yet.

update_block_rich_textUpdate with full rich text specification

Update with full rich text specification

No parameter schema in public metadata yet.

insert_text_afterInsert a text block after a specific block (paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, quote, callout, toggle, to_do, code, divider)

Insert a text block after a specific block (paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, quote, callout, toggle, to_do, code, divider)

No parameter schema in public metadata yet.

insert_blocks_afterInsert multiple blocks after a specific block

Insert multiple blocks after a specific block

No parameter schema in public metadata yet.

append_blocks_to_pageAppend blocks to the end of a page

Append blocks to the end of a page

No parameter schema in public metadata yet.

delete_blockDelete a block by ID

Delete a block by ID

No parameter schema in public metadata yet.

create_commentAdd a comment to a page

Add a comment to a page

No parameter schema in public metadata yet.

list_commentsList all comments on a page or block

List all comments on a page or block

No parameter schema in public metadata yet.

get_databaseGet database metadata and schema

Get database metadata and schema

No parameter schema in public metadata yet.

query_databaseQuery a database with filters and sorts

Query a database with filters and sorts

No parameter schema in public metadata yet.

get_selfGet the current authenticated user/bot

Get the current authenticated user/bot

No parameter schema in public metadata yet.

list_usersList all workspace users

List all workspace users

No parameter schema in public metadata yet.

snapshot_pageSave complete page structure as JSON. include_files also saves Notion-hosted images and files

Save complete page structure as JSON. include_files also saves Notion-hosted images and files

No parameter schema in public metadata yet.

restore_page_from_snapshotRestore page content from a snapshot. Writes first, rolls back on failure, keeps subpages and databases in place, restores deleted ones from trash and re-uploads saved files

Restore page content from a snapshot. Writes first, rolls back on failure, keeps subpages and databases in place, restores deleted ones from trash and re-uploads saved files

No parameter schema in public metadata yet.

upload_fileUpload a file to Notion's own workspace storage (returns file_upload_id)

Upload a file to Notion's own workspace storage (returns file_upload_id)

No parameter schema in public metadata yet.

upload_image_as_blockUpload an image and insert it as a new image block in one step (after a block or appended to a page)

Upload an image and insert it as a new image block in one step (after a block or appended to a page)

No parameter schema in public metadata yet.

replace_image_blockReplace an existing image block with a newly uploaded file, preserving its position

Replace an existing image block with a newly uploaded file, preserving its position

No parameter schema in public metadata yet.

download_image_blockDownload the image file from an image block to disk — works for external URLs, Notion-hosted files, and file_upload references

Download the image file from an image block to disk — works for external URLs, Notion-hosted files, and file_upload references

No parameter schema in public metadata yet.

upload_file_as_blockUpload any file (PDF, attachment) and insert it as a file block

Upload any file (PDF, attachment) and insert it as a file block

No parameter schema in public metadata yet.

insert_table_rowInsert a new row into an existing table with automatic width validation

Insert a new row into an existing table with automatic width validation

No parameter schema in public metadata yet.

update_table_cellReplace the text of a single cell in a table row

Replace the text of a single cell in a table row

No parameter schema in public metadata yet.

Sponsors

Configuration

NOTION_API_TOKEN*secret

Your Notion integration API token (starts with ntn_)

NOTION_MCP_FILE_ROOT

Optional directory that uploads, downloads and snapshots are confined to

Readme

notion-full-mcp

Notion MCP server with deep page reading, surgical block editing, safe snapshot/restore, file uploads (Notion-hosted images and PDFs), table row manipulation, page move and copy, and page restore from trash.

What's new in v0.5.1

  • Tool annotations. Every tool declares whether it is read-only, additive or destructive, so MCP clients can decide what to run without asking.
  • MCP Registry. The server is published to the official MCP Registry as io.github.cphoskins/notion-full-mcp.

What's new in v0.5.0


View the full README on GitHub

Details

Repository
github.com/cphoskins/notion-full-mcp
Category
Documents & Knowledge
Package
notion-full-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from cphoskins

Related Documents & Knowledge MCP servers

View all
1csoai-org avatarLegal Document Ai Mcpcsoai-org/legal-document-ai-mcpLegal Document Ai MCP Server by MEOK AI Labs0stars
2csoai-org avatarPdf Merge Ai Mcpcsoai-org/pdf-merge-ai-mcpPdf Merge Ai MCP Server by MEOK AI Labs0stars
3csoai-org avatarPdf Tools Ai Mcpcsoai-org/pdf-tools-ai-mcpPdf Tools Ai MCP Server by MEOK AI Labs0stars
4csoai-org avatarVector Knowledge Graph Mcpcsoai-org/vector-knowledge-graph-mcpAI-powered vector knowledge graph MCP server for agents. Supports add node, add edge, semantic node0stars
5eigencharlie avatarPdf Toolkit Mcpeigencharlie/pdf-toolkit-mcpUnofficial PDF toolkit (merge/split/compress/OCR/convert/watermark/protect/...) via iLoveAPI.0stars
6huoshuiai42 avatarHuoshui Pdf Translatorhuoshuiai42/huoshui-pdf-translatorAn MCP server that provides PDF translation service0stars