Notion
Connect your agent to Notion to search, read, create, and update pages and databases. Your agent can manage project trackers, knowledge bases, meeting notes, and any other Notion content.
Setup
1. Create an internal integration at notion.so/my-integrations. Copy the integration token.
2. In your agent's Settings, enable Notion and paste the token.
3. In Notion, share the pages and databases you want the agent to access with your integration (click "..." on a page → "Add connections" → select your integration).
Tools
| Tool | Description |
|---|---|
| notion_search | Search pages and databases by keyword |
| notion_query_database | Query a database with filters and sorting |
| notion_create_page | Create a new page or database entry |
| notion_update_page | Update page properties (status, dates, etc.) |
| notion_get_page | Read a page's properties and content |
| notion_append_blocks | Add text, headings, lists, todos to a page |
Querying Databases
Use notion_query_database with Notion filter objects to retrieve specific entries. The agent understands natural language — ask "show me all tasks marked Done" and it builds the right filter.
// Example filter: Status equals "Done"
{ "property": "Status", "status": { "equals": "Done" } }
// Example filter: Created in last 7 days
{ "property": "Created", "date": { "past_week": {} } }Creating Pages
Create pages as children of existing pages or as new entries in a database. For database entries, the agent sets properties matching the database schema (status, select, date, etc.).
Appending Content
Use notion_append_blocks to add content to existing pages. Supports paragraphs, headings (H1-H3), bulleted/numbered lists, to-do items, quotes, callouts, and dividers.
Events
Notion actions emit events to execution history for monitoring. These events are not public automation triggers.
| Event | When |
|---|---|
| notion.searched | A search is performed |
| notion.page_created | A new page is created |
| notion.page_updated | A page's properties are updated |
| notion.database_queried | A database is queried |
| notion.blocks_appended | Content is appended to a page |
Example
User: "Add a new task to my Projects database: 'Launch landing page' with status In Progress and due date March 25"
Agent: Searches for the Projects database, then creates a new entry with the specified properties.
Integration Ideas
Combine with Scheduled Actions for daily syncs (e.g., "every morning, summarize my Notion tasks"). Use with Automations to update Notion when events happen (e.g., "when email received → create Notion page").