Notion integration

Fetch block contents

Retrieves a paginated list of direct, first-level child block objects along with contents for a given parent notion block or page id; use block ids from the response for subsequent calls to access deeply nested content.

Fetch block metadata

Fetches metadata for a notion block (or page, as pages are blocks) using its valid uuid; if the block has children, use fetch block contents to fetch their contents.

Fetch comments

Fetches unresolved comments for a specified notion block or page id.

Fetch data

Fetches notion items (pages and/or databases) from the notion workspace, use this to get minimal data about the items in the workspace with a query or list all items in the workspace with minimal data

Fetch database

Fetches a notion database's structural metadata (properties, title, etc.) via its `database id`, not the data entries; `database id` must reference an existing database.

Fetch row

Retrieves a notion database row's properties and metadata; use fetch block contents for page content blocks.

Get about me

Retrieves the user object for the bot associated with the current notion integration token, typically to obtain the bot's user id for other api operations.

Get about user

Retrieves detailed information about a specific notion user, such as their name, avatar, and email, based on their unique user id.

Get page property action

Call this to get a specific property from a notion page when you have a valid `page id` and `property id`; handles pagination for properties returning multiple items.

List users

Retrieves a paginated list of users (excluding guests) from the notion workspace; the number of users returned per page may be less than the requested `page size`.

Query database

Queries a notion database for pages (rows), where rows are pages and columns are properties; ensure sort property names correspond to existing database properties.

Retrieve comment

Tool to retrieve a specific comment by its id. use when you have a comment id and need to fetch its details.

Add multiple page content

Efficiently adds multiple standard content blocks to a notion page in a single api call with automatic markdown parsing. the 'content' field in notionrichtext blocks now automatically detects and parses markdown formatting including headers (# ## ###), bold (**text**), italic (*text*), strikethrough (~~text~~), inline code (`code`), links ([text](url)), and more. ideal for bulk content creation, ai agents, and replacing multiple individual add page content calls. supports automatic text formatting, content splitting, and up to 100 blocks per request.

Add page content

Deprecated: appends a single content block to a notion page or a parent block (must be page, toggle, to-do, bulleted/numbered list, callout, or quote); invoke repeatedly to add multiple blocks.

Append block children

Appends complex blocks with full notion block structure to a parent block or page. use for advanced scenarios requiring precise control: code blocks, tables, embeds, nested children within blocks, or when working with pre-built notion block objects. requires full notion api block schema - use add multiple page content for simpler content creation.

Archive notion page

Archives (moves to trash) or unarchives (restores from trash) a specified notion page.

Create comment

Adds a comment to a notion page (via `parent page id`) or to an existing discussion thread (via `discussion id`); cannot create new discussion threads on specific blocks (inline comments).

Create database

Creates a new notion database as a subpage under a specified parent page with a defined properties schema; use this action exclusively for creating new databases.

Create notion page

Creates a new empty page in a notion workspace.

Delete block

Archives a notion block, page, or database using its id, which sets its 'archived' property to true (like moving to "trash" in the ui) and allows it to be restored later.

Duplicate page

Duplicates a notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace.

Insert row database

Creates a new page (row) in a specified notion database.

Update block

Updates an existing notion block's textual content or type-specific properties (e.g., 'checked' status, 'color'), using its `block id` and the specified `block type`.

Update page

Tool to update the properties, icon, cover, or archive status of a page. use when you need to modify existing page attributes.