Notion
Comprehensive Notion connector for managing databases, pages, blocks, users, and content operations.
What you can ask
- Search the
Engineering Wikifor pages last edited over 60 days ago and taggedrunbookfor archive review. - Add a new entry to the
Decisions Logdatabase with today's architecture decision. - Find every page in
Product / Specsblocked on review and DM the reviewer.
Set up
Notion connects with credentials from your Notion account. Have these values ready:
- Integration token
- Go to Organization > Connectors and find Notion.
- Click Enable and choose which tools to allow.
- Each member enters their own values the first time they use it.
To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.
Tools
Notion offers 22 tools. Admins choose which ones agents can use. See Tool permission groups.
Read (13)
View and search information without changing it.
| Tool | What it does |
|---|---|
get_block | Retrieve a block by ID |
get_block_children | Retrieve children of a block with pagination |
get_bot_user | Retrieve the current integration's bot user |
get_data_source | Retrieve a data source and its property schema. |
get_database | Retrieve a database container by ID: title, parent, and the data_sources it holds. |
get_page | Retrieve a page by ID |
get_page_property | Retrieve a specific page property. |
get_user | Retrieve a user by ID |
list_comments | List comments for a block or get ALL comments from an entire page |
list_users | List all users in the workspace |
query_database | Query the pages in a database or data source, with filtering, sorting and pagination. |
search | Search pages and data sources by title or body content. |
validate_credential | Validate Notion credentials by fetching the bot user. |
Write (4)
Create or send data.
| Tool | What it does |
|---|---|
append_block_children | Append child blocks to a page or block. position accepts only type after_block, start or end. |
create_comment | Create a comment on a page or block, or reply to an existing thread by passing discussion_id from list_comments. |
create_database | Create a database under a page. properties defines the initial data source schema; title and description are rich text arrays. |
create_page | Create a page under an existing page or database; workspace-level pages are not supported. |
Delete or overwrite (5)
Remove or replace existing data.
| Tool | What it does |
|---|---|
archive_page | Archive a page (move to trash) |
delete_block | Delete a block |
update_block | Update a block's content or archive status. |
update_database | Update a database's title, description, icon, cover, or property schema. title and description are rich text arrays. |
update_page | Update a page's properties, icon, cover, or archive status, e.g. properties {"Status": {"select": {"name": "Done"}}}. |