Skip to main content
Connect agents to Notion to create, read, update, and search pages, databases, and workspace content programmatically.

​
Setup

  1. In Agent Studio, go to Tools → Notion → Connect
  2. Sign in with your Notion account and authorize access
  3. Review the requested permissions and click Allow

​
Composio vs ACI: Which provider to use?

This tool is available through two providers. Both connect to the same underlying service but differ in action coverage and auth handling.
ComposioACI
Provider sourceComposioACI
Auth typeoauth2oauth2
Best forBroad action coverage, workflow automationTargeted integrations, API-level operations
Choose Composio when you need the widest selection of actions and deep workflow automation. Choose ACI when you need direct API-level control or a specific action not covered by Composio.

​
Available actions: Composio

ActionDescription
NOTION_ADD_MULTIPLE_PAGE_CONTENTAdds multiple content blocks to a Notion page in a single call with automatic markdown parsing, supporting up to 100 blocks per request.
NOTION_APPEND_BLOCK_CHILDRENAppends complex blocks using the full Notion block structure to a parent block or page, for advanced scenarios requiring precise control.
NOTION_ARCHIVE_NOTION_PAGEArchives or restores a specified Notion page by toggling its archived status.
NOTION_CREATE_COMMENTAdds a comment to a Notion page or to an existing discussion thread.
NOTION_CREATE_DATABASECreates a new Notion database as a subpage under a specified parent page with a defined properties schema.
NOTION_CREATE_NOTION_PAGECreates a new empty page in a Notion workspace under a specified parent page or database.
NOTION_DELETE_BLOCKArchives a Notion block, page, or database by its ID, which can be restored later.
NOTION_DUPLICATE_PAGEDuplicates a Notion page including all its content, properties, and nested blocks under a specified parent.
NOTION_FETCH_BLOCK_CONTENTSRetrieves a paginated list of direct child block objects and their contents for a given parent block or page.
NOTION_FETCH_BLOCK_METADATAFetches metadata for a Notion block or page using its UUID.
NOTION_FETCH_COMMENTSFetches unresolved comments for a specified Notion block or page.
NOTION_FETCH_DATAFetches Notion pages and/or databases from the workspace, optionally filtered by a search query.
NOTION_FETCH_DATABASEFetches a Notion database’s structural metadata such as properties and title via its database ID.
NOTION_FETCH_ROWRetrieves a Notion database row’s properties and metadata using the row’s page ID.
NOTION_GET_ABOUT_MERetrieves the bot user object associated with the current Notion integration token.
NOTION_GET_ABOUT_USERRetrieves detailed information about a specific Notion user by their unique user ID.
NOTION_GET_PAGE_PROPERTY_ACTIONRetrieves a specific property from a Notion page using the page ID and property ID, with pagination support.
NOTION_INSERT_ROW_DATABASECreates a new page (row) in a specified Notion database with the given property values.
NOTION_LIST_USERSRetrieves a paginated list of users (excluding guests) from the Notion workspace.
NOTION_QUERY_DATABASEQueries a Notion database for pages (rows) with optional sorting and pagination.
NOTION_RETRIEVE_COMMENTRetrieves the details of a specific comment by its ID.
NOTION_RETRIEVE_DATABASE_PROPERTYRetrieves a specific property object from a Notion database by database ID and property ID.
NOTION_SEARCH_NOTION_PAGESearches Notion pages and databases by title, returning all accessible items if no query is provided.
NOTION_UPDATE_BLOCKUpdates the textual content or type-specific properties of an existing Notion block by its ID.
NOTION_UPDATE_PAGEUpdates the properties, icon, cover, or archive status of an existing Notion page.
NOTION_UPDATE_ROW_DATABASEUpdates or archives an existing Notion database row (page) including its icon, cover, and properties.
NOTION_UPDATE_SCHEMA_DATABASEUpdates an existing Notion database’s title, description, or property schema.

​
Available actions: ACI

ActionDescription
NOTION__GET_PAGERetrieves a Notion page object using its ID, returning page properties but not page content.
NOTION__SEARCH_PAGESSearches all pages shared with the integration and returns those with titles matching the query.
NOTION__TOGGLE_PAGE_ARCHIVEArchives or restores a Notion page by setting its archived status to true or false.
NOTION__RESTORE_PAGERestores a Notion page from trash by setting its archived property to false.
NOTION__LIST_USERSReturns a paginated list of users in the workspace, excluding guests.
NOTION__GET_USERRetrieves a specific Notion user by their user ID.
NOTION__GET_MERetrieves the bot user associated with the API token provided in the authorization header.
NOTION__CREATE_PAGECreates a new page as a child of an existing page or database, with optional content blocks.

​
Adding to an agent

  1. Open your agent in Agent Studio → Agent Builder
  2. Go to Tools and enable Notion
  3. Select only the actions your agent needs
  4. Set auth mode: Shared (agent acts on one account) or Per-user (each end-user connects their own account)

​
Example use cases

Automated meeting notes to Notion After a meeting, an agent creates a new Notion page under a specified parent using NOTION_CREATE_NOTION_PAGE, then appends structured meeting notes with action items using NOTION_ADD_MULTIPLE_PAGE_CONTENT. Project tracker database management An agent uses NOTION_QUERY_DATABASE to fetch open tasks from a project tracker, updates task statuses with NOTION_UPDATE_ROW_DATABASE, and inserts new tasks from external sources using NOTION_INSERT_ROW_DATABASE. Knowledge base search and retrieval An agent searches the Notion workspace for relevant documentation using NOTION_SEARCH_NOTION_PAGE or NOTION_FETCH_DATA, then retrieves the full content of matching pages using NOTION_FETCH_BLOCK_CONTENTS to answer user questions.