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 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
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
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
