Notion MCP Server
for AI Agents

Add content blocks (text, headings, lists, images, etc.) to an existing page or block. Use this after create_page to add more content, or to append to any existing page. The block_id parameter accepts a page_id directly.

Retrieve the content blocks inside a page or parent block. This is how you read a page's actual content (text, headings, lists, etc.) — get_page only returns properties/metadata, not content.

Retrieve a single block's type, content, and metadata by its block_id (does NOT return children — use get_block_children for nested content).

Modify an existing block's content (text, headings, to-dos, etc.) by block_id. ALWAYS call this after reading blocks when the user asks to change or update existing content. First use get_block_children to find the block_id and type, then call this action with the new content.

Archive (soft-delete) a block by its block_id. The block is moved to trash, not permanently deleted — it can be restored by setting in_trash to false via update_block.

Create a comment on a page or block, or reply to an existing discussion thread. Use the page_id directly from create_page or search results — no need to re-search after creation.

List all unresolved comments on a page or block, with pagination. Resolved comments are excluded from results.

Retrieve a single comment's full details (content, author, timestamps, parent) by its comment_id.

Create a new Notion database under a parent page, with an optional initial schema (columns/properties) defined via initial_data_source. Returns the database object including its data_sources list.

Retrieve a database's metadata and its list of data sources (with IDs) by database_id. Does NOT return rows — use query_data_source for that. Use retrieve_data_source to get a data source's schema.

Update database-level attributes (title, icon, cover, parent, archive status). To update columns/schema, use update_data_source instead.

Add a new data source (with its own schema/columns) to an existing database. Use this when a database needs multiple data sources with different property schemas.

Retrieve a data source's schema (columns/properties) by its data_source_id. To get rows, use query_data_source instead. Get the data_source_id from get_database.

Query a database's data source to retrieve rows (pages) with optional filtering and sorting. This is how you list or search for rows in a Notion database.

Update a data source's schema (add, rename, or remove columns), title, icon, or trash status. To update row values, use update_page instead.

Step 1 of file upload — create a file upload session to get an upload URL. Then call send_file_upload (step 2), and complete_file_upload (step 3, multi_part only).

Step 2 of file upload — send the actual file data for a file upload session created by create_file_upload. For multi_part, call complete_file_upload after all parts are sent.

List all file uploads created by this bot integration, sorted most recent first. Filter by status (pending, uploaded, expired, failed) to find specific uploads.

Retrieve a single file upload's metadata and status (pending, uploaded, expired, failed) by its file_upload_id. Use after send_file_upload to verify upload completion.

List unified organizations in Notion.

Get a unified Notion organization by ID.

List unified users in Notion.

Get a unified Notion user by ID.

Create a new page in a Notion workspace. After creation, the returned page object contains the new page_id — use it directly for follow-up actions (append_block_children, create_comment, move_page) without re-searching.

Retrieve a Notion page's properties and metadata by its page_id (does NOT return page content — use get_block_children for that).

Update page properties, icon, cover, or trash status by page ID. IMPORTANT — You must already have the page_id; if you only have a page name or title, you MUST call search first to find the page_id before calling this action. This action CANNOT look up pages by name. To change a page's parent location, use move_page instead.

Move a page to a different parent page or database. THIS IS THE ONLY ACTION that can change a page's parent location — update_page CANNOT do this. Use move_page whenever the user asks to "move", "relocate", "reparent", or "transfer" a page to a new location.

List ALL users (people and bots) in the Notion workspace. Returns the complete set of workspace members across all pages — always iterate through ALL results and report the full count. Guests are excluded by Notion.

Retrieve a single Notion user's profile (name, email, avatar, type) by their user_id. Get user IDs from list_users results.