Notion

Let your agents read and write your Notion workspace — search, query databases, and create or update pages, blocks and comments.

Connection

Authentication: API key (Internal integration secret (ntn_/secret_…)).

Go to notion.so/my-integrations → New integration → pick your workspace and name it. Under Capabilities enable “Read content”, “Update content”, “Insert content” and comment read/insert, then copy the Internal Integration Secret (starts with ntn_ or secret_). Finally, open each page or database the agent should access and share it via ••• → Connections → your integration.See Notion’s documentation.

Read actions (13)

Action	Description
`get_block`	Retrieve a single block.
`get_bot_user`	Retrieve the integration’s own bot user (verifies the token).
`get_database`	Retrieve a database object including its property schema.
`get_page`	Retrieve a page and its property values.
`get_page_property_item`	Retrieve a single property item of a page (paginated for long values).
`get_user`	Retrieve a user by ID.
`list_block_children`	List the child blocks of a block or page (use to read page content).
`list_comments`	List open comments on a page or block.
`list_users`	List all users in the workspace (members and bots).
`query_database`	Query a database — list its pages with optional filters and sorts.
`search`	Search all pages and databases shared with the integration by title.
`search_databases`	Search databases by title (results filtered to databases only).
`search_pages`	Search pages by title (results filtered to pages only).

Write actions (15)

Action	Description
`append_block_children`	Append raw block objects as children of a block or page (args: block_id, children: object[], after?).
`append_bulleted_list`	Append a bulleted list (one item per string) to a page or block (args: block_id, items: string[]).
`append_callout`	Append a callout block — highlighted note with optional emoji icon (args: block_id, text, emoji?, color?).
`append_code_block`	Append a code block with syntax highlighting (args: block_id, code, language, caption?).
`append_paragraph`	Append a plain-text paragraph to a page or block (args: block_id, text).
`append_to_do`	Append to-do checkbox items (args: block_id, items: string[], checked?).
`archive_page`	Archive a page — move it to trash (args: page_id).
`create_comment`	Add a comment to a page or reply to a thread (args: text, page_id? or discussion_id? — exactly one).
`create_database`	Create a database as a child of a page, with a property schema (args: parent_page_id, title, properties, is_inline?).
`create_page`	Create a page under a parent page or as an entry in a database (args: parent, properties, children?, icon?, cover?).
`delete_block`	Delete (archive) a block (args: block_id).
`restore_page`	Restore an archived page from trash (args: page_id).
`update_block`	Update the content of a block (pass the block-type object) or its archived state (args: block_id, block?, archived?).
`update_database`	Update the title, description or property schema of a database (args: database_id, title?, description?, properties?).
`update_page`	Update the properties, icon, cover or archived state of a page (args: page_id, properties?, archived?, icon?, cover?).

Permissions

Every action above must be explicitly granted to an agent before it can be used. See Permissions for the grant model and Security for how credentials are protected.

Last reviewed against the provider API: July 2026.

Using integrations

Communication

Scheduling

Project management

Docs & design

Files & storage

CRM & sales

Customer support

HR & recruiting

Commerce & billing

Developer tools

Observability & analytics

AI & media

Connection

Read actions (13)

Write actions (15)

Permissions

​Connection

​Read actions (13)

​Write actions (15)

​Permissions

Connection

Read actions (13)

Write actions (15)

Permissions