Welcome to the Notion integration docs. Once you connect your Notion account to Reasoning Stack, your AI agents and workflows can use the following tools to create pages, manage databases, append content, and automate Notion operations programmatically.
Before accessing any Notion tools, connect your Notion account via the App Connection page. Without this, tool calls will fail due to missing authorization.

​
Notion Tool Categories

​
Page & Block Management

  • NOTION_CREATE_NOTION_PAGE – Creates a new page in a Notion workspace.
  • NOTION_ADD_PAGE_CONTENT – Appends a single content block to a Notion page or parent block; call repeatedly to add multiple blocks.
  • NOTION_APPEND_BLOCK_CHILDREN – Appends child blocks to a parent block or page, adding content inside existing structures.
  • NOTION_UPDATE_PAGE – Updates properties, icon, cover, or archive status of a page.
  • NOTION_ARCHIVE_NOTION_PAGE – Archives or unarchives a specified Notion page (moves to/from trash).
  • NOTION_DUPLICATE_PAGE – Duplicates a Notion page with all content under a specified parent or workspace.
  • NOTION_DELETE_BLOCK – Archives a Notion block, page, or database by setting its ‘archived’ property to true.
  • NOTION_FETCH_NOTION_BLOCK – Retrieves a Notion block or page by ID (separate action needed for children).
  • NOTION_FETCH_NOTION_CHILD_BLOCK – Retrieves a paginated list of direct child blocks for a given parent block or page.
  • NOTION_NOTION_UPDATE_BLOCK – Updates an existing block’s text content or type-specific properties.

​
Database Management

  • NOTION_CREATE_DATABASE – Creates a new Notion database as a subpage under a specified parent page with defined properties.
  • NOTION_FETCH_DATABASE – Fetches a Notion database’s structural metadata by its database ID.
  • NOTION_QUERY_DATABASE – Queries a Notion database for pages (rows) with sorting and pagination.
  • NOTION_INSERT_ROW_DATABASE – Creates a new page (row) in a specified Notion database.
  • NOTION_FETCH_ROW – Retrieves a database row’s properties and metadata (not the page content blocks).
  • NOTION_UPDATE_ROW_DATABASE – Updates or archives an existing database row (page) using its row ID.
  • NOTION_UPDATE_SCHEMA_DATABASE – Updates a database’s title, description, and/or properties.
  • NOTION_RETRIEVE_DATABASE_PROPERTY – Retrieves details about a single database property by database and property ID.

​
Comments

  • NOTION_CREATE_COMMENT – Adds a comment to a Notion page or existing discussion thread (no inline block comments).
  • NOTION_FETCH_COMMENTS – Fetches unresolved comments for a specified block or page.
  • NOTION_RETRIEVE_COMMENT – Retrieves a specific comment by its ID.

​
User & Workspace

  • NOTION_GET_ABOUT_ME – Retrieves the user object for the bot linked to the current integration token.
  • NOTION_GET_ABOUT_USER – Retrieves detailed info (name, avatar, email) for a specific Notion user by user ID.
  • NOTION_LIST_USERS – Retrieves a paginated list of users (excluding guests) from the workspace.

​
Search & Utility

  • NOTION_FETCH_DATA – Simplifies retrieval of Notion items, abstracting native API complexity.
  • NOTION_GET_PAGE_PROPERTY_ACTION – Retrieves a specific property from a Notion page, with pagination support.
  • NOTION_SEARCH_NOTION_PAGE – Searches pages and databases by title; empty query returns all accessible items.

​
Usage Notes

  • Handle page, block, and database IDs carefully to avoid errors.
  • Use append and update tools to automate content creation and editing.
  • Combine database, comment, and search tools for advanced Notion workflows.
Automate documentation, project management, and knowledge base updates by combining multiple Notion tools in your Reasoning Stack workflows.