27 things your agent can do in Notion

Fetch Notion Block Children

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 de…

Fetch Notion 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 Notion 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 database 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

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 Database Property

Tool to retrieve a specific property object of a notion database. use when you need to get details about a single database column/property.

Search Notion page

Searches notion pages and databases by title; an empty query lists all accessible items, useful for discovering ids or as a fallback when a specific query yields no results.

Add multiple content blocks (bulk, user-friendly)

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 par…

Archive Notion Page

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

Create Notion 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 a 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.

Update row database

Updates or archives an existing notion database row (page) using its `row id`, allowing modification of its icon, cover, and/or properties; ensure the target page is accessible and property details (…

Update database schema

Updates an existing notion database's title, description, and/or properties; at least one of these attributes must be provided to effect a change.

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).

Retrieve Comment

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

Append complex blocks (advanced, full control)

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…