> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Connect Notion to your Atako agents — 13 read and 15 write actions.

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

<Note>
  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](https://www.notion.so/my-integrations).
</Note>

## 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](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: July 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.