Notion Toolkit
The Notion Toolkit is a workflow node. Its tools include Search, List Databases, Get Database, and Query Database, plus 5 more listed below. Connect a Notion account before you use any of these tools. Type @ in a field when the value should come from an earlier step.
Authentication
Every Notion tool needs a connected account before it can run. On the node, open Notion Account.
- Choose Use my Notion account or Use team account.
- If no personal account is connected, click Connect Notion Account and finish sign-in.
- For a team account, choose Use team account and pick one from Team account. The list shows accounts already connected for the project.
Tools
Search
Runs the search tool.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Query | No | Text to search for across all pages and databases accessible to the integration. Default is null. Type @ to select a variable. |
| Filter Type | No | Object type to filter results by: 'page' or 'database'. Omit to search all. Default is null. Type @ to select a variable. |
| Page Size | No | Maximum number of results to return (1-100). Default is 10. |
| Start Cursor | No | Cursor from a previous response for pagination. Default is null. Type @ to select a variable. |
List Databases
Lists databases.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Page Size | No | Maximum number of databases to return (1-100). Default is 20. |
| Start Cursor | No | Cursor from a previous response for pagination. Default is null. Type @ to select a variable. |
Get Database
Retrieves database.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Database ID | Yes | ID of the Notion database to retrieve. Type @ to select a variable. |
Query Database
Runs the query database tool.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Database ID | Yes | ID of the Notion database to query. Type @ to select a variable. |
| Query Filter | No | Filter criteria as a Notion filter object (e.g. {"property": "Status", "select": {"equals": "Done"}}). Default is null. |
| Sorts | No | Sort criteria as a list of Notion sort objects (e.g. [{"property": "Created", "direction": "descending"}]). Default is null. |
| Page Size | No | Maximum number of results to return (1-100). Default is 20. |
| Start Cursor | No | Cursor from a previous response for pagination. Default is null. Type @ to select a variable. |
Get Page
Retrieves page.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Page ID | Yes | ID of the Notion page to retrieve. Type @ to select a variable. |
Create Page
Creates page.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Parent ID | Yes | ID of the parent database or page where the new page will be created. Type @ to select a variable. |
| Parent Type | No | Type of parent: 'database_id' (to add a row to a database) or 'page_id' (to create a sub-page). Default is database_id. Type @ to select a variable. |
| Title | Yes | Title of the new page. Type @ to select a variable. |
| Properties | No | Additional page properties as a Notion properties object (for database rows). Default is null. |
Update Page
Updates page.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Page ID | Yes | ID of the Notion page to update. Type @ to select a variable. |
| Properties | Yes | Properties to update as a Notion properties object (e.g. {"Status": {"status": {"name": "Done"}}}). |
| Archived | No | Set to true to archive (soft-delete) the page. Default is null. |
Get Page Content
Retrieves page content.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Page ID | Yes | ID of the Notion page whose content blocks to retrieve. Type @ to select a variable. |
| Page Size | No | Maximum number of blocks to return (1-100). Default is 50. |
| Start Cursor | No | Cursor from a previous response for pagination. Default is null. Type @ to select a variable. |
Append Block Children
Runs the append block children tool.
| Field | Required | Description |
|---|---|---|
| Notion Account | Yes | Select your personal or team Notion account. |
| Page ID | Yes | ID of the Notion page or block to append content to. Type @ to select a variable. |
| Children | Yes | List of Notion block objects to append (e.g. [{"object": "block", "type": "paragraph", "paragraph": {"rich_text": [{"type": "text", "text": {"content": "Hello"}}]}}]). |
Related
Agents can use this integration from chat. See Notion.
See all integrations on the toolkits overview.