Notion

• You want an AI agent to automatically create or update Notion pages, such as generating meeting notes, task entries, or reports.
• You need to query a Notion database with filters and sorts to retrieve structured records (e.g. active tasks, CRM entries, project trackers).
• You want to programmatically add content blocks (paragraphs, lists, etc.) to existing pages.
• You need to create new databases (data sources) inside a Notion page as part of an automated workflow.

• You need to set or modify database view filters — those are UI-only and cannot be changed via the API.
• You require very high-throughput operations — the Notion API rate limit is approximately 3 requests/second, which may be a bottleneck for bulk jobs.
• The target pages or databases have not been shared with your Notion integration; access must be granted manually in the Notion UI.

Retrieve page metadata and content, create new pages inside databases or as children of other pages, and update page properties via PATCH. Supports all common property types including title, rich text, select, date, checkbox, URL, and relations.

Query Notion databases using filters and sort orders via the /data_sources/{id}/query endpoint introduced in API version 2025-09-03. Filter by property values such as status, date, or select fields and retrieve paginated results.

Append rich content blocks — including paragraphs and other block types — directly to any page. Retrieve the full block tree of a page to read its content structure.

Create new structured databases (data sources) as children of existing pages, with custom property schemas including titles, selects, dates, and more. Use is_inline: true to embed them inline within a page.

Search across all pages and databases accessible to your integration using the /search endpoint. Results include both pages and data sources, identified by their respective object types and IDs.

This skill targets Notion API version 2025-09-03, which introduces the data sources naming convention. Detailed guidance is provided on the dual-ID system (database_id vs data_source_id) and when each should be used.

An agent can query a Notion project database for items with a specific status (e.g. "Active"), update properties as work progresses, and create new task entries — keeping your Notion workspace in sync with external events or agent decisions.

After generating a report, summary, or briefing, an agent can create a new Notion page and append the content as structured blocks, making AI outputs immediately available in your team's knowledge base.

Automatically add new records to a Notion database with structured properties (name, status, date, URL) as leads, contacts, or data points are collected — replacing manual data entry.

An agent can search your Notion workspace for relevant pages or databases by title keyword and fetch their content, enabling context retrieval for downstream reasoning or summarization tasks.