Notion integration: operations for AI agents
Notion connects to Type.com as an integration. This page lists the 15 operations documented for Claude and Codex in Type.com: 6 read, 8 write, 1 destructive.
About Notion
Search, read and write your Notion workspace: pages, blocks, databases (data sources) and comments.
Categories: Productivity, Documents
How to connect Notion to Type.com
- Connect
- Sign in with Notion (OAuth)
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
15 operations. Your connection's permissions determine which operations are available.
- Read
Notion get block children
Get the children blocks of a page or block. Use fetch_all=true to automatically retrieve all pages for large documents.
- Read
Notion query database
Query a Notion database or data source. Returns pages that match the filter criteria. IMPORTANT: Use notion_retrieve_data_source FIRST to get the property schema — filter/sort property names must match exactly (case-sensitive). For complete enumeration, continue with next_cursor while has_more is true; large property payloads may reduce the requested page size. Note: Relations/People properties limited to 25 references.
- Read
Notion retrieve block
Retrieve a Notion block by ID. Returns the block's type and content.
- Read
Notion retrieve data source
Retrieve a Notion data source (database) by ID. Returns the database schema including all property names and types. Call this before notion_query_database to discover available properties for filtering/sorting.
- Read
Notion retrieve page
Retrieve a Notion page by ID. Returns the page's properties and metadata.
- Read
Notion search
Search for pages and databases in Notion. Returns matching pages with titles and URLs. Use filter to narrow results to just pages or just databases (data sources).
- Write
Notion append block children
Append content blocks to a page or block. Use this to add new content. Also use this to 'move' blocks by first deleting them then recreating here. Limits: Max 100 blocks per request. Max 2 levels of nested children per request.
- Write
Notion create comment
Add a comment to a Notion page or discussion.
- Write
Notion create data source
Create a new Notion data source (database) under a parent page.
- Write
Notion create page
Create a new Notion page. Provide a parent (page_id or database_id), title, and optional content blocks. If parent is a string ID, you must specify parent_type to disambiguate page vs database. For database parents, use title_property or set the title property explicitly in properties. Limits: Rich text limited to 2000 chars per object. Max 100 blocks per request. Max 2 levels of nested children per request.
- Write
Notion move page
Move a Notion page to a new parent (page or database). Note: When moving to a database, the page properties must match the database schema.
- Write
Notion update block
Update an existing Notion block. Provide the block_id and the block type field with new content. Supported types: paragraph, heading_1, heading_2, heading_3, bulleted_list_item, numbered_list_item, toggle, to_do, quote, callout, code, divider, image, video, file, pdf, embed, bookmark, link_preview, equation. Limits: Rich text limited to 2000 chars per object. LIMITATION: Notion API cannot update table cell contents. Table rows (table_row blocks) are read-only. To modify table data, delete the entire table and recreate it.
- Write
Notion update data source
Update a Notion data source (database) schema or title.
- Write
Notion update page
Update a Notion page's properties or metadata (archived/icon/cover).
- Destructive
Notion delete block
Delete a Notion block. This permanently removes the block. LIMITATION: Notion API cannot move or reorder existing blocks. To move a block, you must: 1) Read its content, 2) Delete it with notion_delete_block, 3) Recreate it in the new location with notion_append_block_children. This loses the original block ID.
No operations match.
Not supported
- Pages that haven't been shared with the type.com integration
- Reordering or moving existing blocks (they must be deleted and recreated)
- Managing workspace members or permissions
Example prompts
- Find our onboarding doc in Notion and summarize it.
- Add a row to the Content Calendar database for next Tuesday's post.
- Append today's meeting notes to the Weekly Sync page.
Get started
- Open Space settings → Connections and search for Notion.
- Connect your account and add the connection to the Space.
- Ask for what you need in any thread in that Space.
See How connections work for access and permissions, or browse all integrations.