notion-mcp

Search Notion for pages the integration has access to. Returns titles and page IDs — use these IDs with notion_upload_file / list_files_on_page. The integration only sees pages explicitly shared with it in Notion. in_trash=True searches trashed pages instead of active ones (restore matches with noti…

Search Notion for databases the integration has access to. Returns titles, IDs, and property schemas. Use the database ID with notion_query_database, notion_describe_database, or notion_create_page (with database_id).

List all file/image/pdf/video/audio blocks on a Notion page. Returns block IDs and filenames — use block IDs with notion_download_file.

Delete files from the cross-MCP shared mount (SHARED_DIR, /shared inside the container) whose modification time is older than max_age_hours. Use this to clean up attachments handed over from the companion google-accounts-mcp server once they've been uploaded to Notion.

Delete a single file from the cross-MCP shared mount by bare filename. Use this after a successful upload to free the shared slot instead of waiting for the daily TTL sweep (or calling notion_purge_shared_files with max_age_hours=0, which would wipe any unrelated in-flight handoffs). Rejects any fil…

List files available to notion-mcp by scheme, so the agent can verify a handoff before attaching it to Notion.

Upload a file to Notion and attach it as a new block.

Replace the file inside an EXISTING file/image/pdf/video/audio block, in place — the block keeps its position on the page. Use this to update a document without re-arranging anything; use notion_upload_file(position=...) to add a new block instead.

Import a file into Notion directly from a public HTTPS URL — the bytes go Notion-side, never through this server or MCP parameters.

Set or remove a Notion page's icon or cover image.

Retrieve a Notion database's schema. Returns each property name and type — use this to find the exact files & media column name to pass to notion_upload_file_to_database / notion_add_file_to_row.

Upload a file and create a NEW row in a Notion database with the file attached to the given files & media column.

Upload a file and attach it to an EXISTING database row's files & media column.

Attach files to many existing Notion rows in one call.

Download a file from a Notion file/image/pdf/video/audio block.

Extract text from a PDF anywhere notion-mcp can reach — a file stored in Notion, the shared cross-MCP mount, the private store, or the Drive folder — without moving the bytes over MCP.

Read a Notion page's properties and content as markdown.

Create a new Notion page with optional markdown content.

Update a Notion page's title, icon, or other properties.

Append markdown content to an existing Notion page.

Archive (soft-delete) a Notion page. The page can be restored from the Notion trash within 30 days using notion_restore_page.

Restore an archived page from the Notion trash.

Update an existing block's text content.

Delete a block from a Notion page. This removes the block and all its children. The deletion is permanent (blocks cannot be restored).

Query a Notion database with optional filter, sort, and pagination.

Create a new Notion database under a page.

Update a Notion database's title, description, or property schema.

Retrieve a single property from a Notion page with full pagination.

Get all comments on a Notion page.

Add a comment to a Notion page or reply to a discussion thread.

Edit a comment previously created by this integration (Notion returns 404 for comments created by anyone else).

Delete a comment previously created by this integration (Notion returns 404 for comments created by anyone else).

List the views defined on a Notion database — name, type, id, and whether each carries a saved filter/sorts. Use the view id with notion_query_view to run a view's saved filter, or with notion_update_view / notion_delete_view to manage it.

Run a database view's saved filter and sorts, returning the matching rows (title + id + url). Use this instead of notion_query_database when the view already encodes the filter you want — no filter JSON needed.

Create a view on a Notion database.

Update a view's name, saved filter, and/or sorts. Only provided fields change (fields left empty are preserved).

Delete a view from its database. The database and its rows are untouched — only the saved view configuration is removed.

List all users in the Notion workspace.

Get details for a specific Notion user by ID.

Read a Notion page's content as native Notion-flavored markdown.

Edit page content using search-and-replace on the page's markdown.

Replace a page's entire content with new markdown.

Move a Notion page to a new parent page or database.