
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 toolsPublic 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*secretYour Notion integration API token (starts with ntn_)
NOTION_MCP_FILE_ROOTOptional 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
Details
- Repository
- github.com/cphoskins/notion-full-mcp
- Category
- Documents & Knowledge
- Package
notion-full-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active