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 Integrations from the sidebar
- Select Notion from the catalog
- Click Add Integration Config
- 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 config
Using in Your Agent
- Open your agent in Agent Studio and select an Agent Step
- Under Attached Integration Configurations, click Attach configuration and choose your config
- Attach Notion tools from the tools panel
- 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 |