Skip to content
Changelog

Report a bug

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.

  • 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.

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

  1. Open Space settings → Connections and search for Notion.
  2. Connect your account and add the connection to the Space.
  3. Ask for what you need in any thread in that Space.

See How connections work for access and permissions, or browse all integrations.