Notion
Notion API integration for pages, databases, and workspace management
The Notion integration lets your agents search, read, create, and update pages and databases in Notion workspaces.
Prerequisites
You need one of the following:
- Internal Integration Token — Create an integration at Notion Developers. Copy the token, then share the relevant Notion pages/databases with your integration.
- OAuth — For user-level access where each chat user authorizes with their own Notion account.
Setup
- Open your agent in Agent Studio
- In the Integrations panel, click Add Integration Config
- Select Notion from the integration list
- Give the config a display name (e.g., "Notion - Team Wiki")
- Choose your authentication method:
- Internal Integration Token — Paste the token from your Notion integration
- OAuth — Click Connect to start the Notion OAuth flow
- Save the agent revision
Using in Your Agent
- In an Agent Step, attach Notion tools from the tools panel
- The agent uses your integration config for all Notion API calls
- Tools are referenced as
notion.search,notion.create_page, etc.
Available Tools
| Tool | Description | Action Type |
|---|---|---|
search | Search for pages and databases by title | ReadOnly |
get_page | Retrieve a Notion page by its ID | ReadOnly |
create_page | Create a new page in Notion | Reversible |
update_page | Update properties of a Notion page | Reversible |
get_database | Retrieve a Notion database schema and properties | ReadOnly |
query_database | Query a Notion database to retrieve pages | ReadOnly |
get_block_children | Retrieve the content blocks of a Notion page | ReadOnly |
append_blocks | Append new content blocks to a Notion page | Reversible |
create_comment | Add a comment to a Notion page | Irreversible |
list_users | List all users in the Notion workspace | ReadOnly |