Notion

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

Setup

In Agent Studio, go to Tools → Notion → Connect
Sign in with your Notion account and authorize access
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.

	Composio	ACI
Provider source	Composio	ACI
Auth type	oauth2	oauth2
Best for	Broad action coverage, workflow automation	Targeted 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

Action	Description
`NOTION_ADD_MULTIPLE_PAGE_CONTENT`	Adds 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_CHILDREN`	Appends complex blocks using the full Notion block structure to a parent block or page, for advanced scenarios requiring precise control.
`NOTION_ARCHIVE_NOTION_PAGE`	Archives or restores a specified Notion page by toggling its archived status.
`NOTION_CREATE_COMMENT`	Adds a comment to a Notion page or to an existing discussion thread.
`NOTION_CREATE_DATABASE`	Creates a new Notion database as a subpage under a specified parent page with a defined properties schema.
`NOTION_CREATE_NOTION_PAGE`	Creates a new empty page in a Notion workspace under a specified parent page or database.
`NOTION_DELETE_BLOCK`	Archives a Notion block, page, or database by its ID, which can be restored later.
`NOTION_DUPLICATE_PAGE`	Duplicates a Notion page including all its content, properties, and nested blocks under a specified parent.
`NOTION_FETCH_BLOCK_CONTENTS`	Retrieves a paginated list of direct child block objects and their contents for a given parent block or page.
`NOTION_FETCH_BLOCK_METADATA`	Fetches metadata for a Notion block or page using its UUID.
`NOTION_FETCH_COMMENTS`	Fetches unresolved comments for a specified Notion block or page.
`NOTION_FETCH_DATA`	Fetches Notion pages and/or databases from the workspace, optionally filtered by a search query.
`NOTION_FETCH_DATABASE`	Fetches a Notion database’s structural metadata such as properties and title via its database ID.
`NOTION_FETCH_ROW`	Retrieves a Notion database row’s properties and metadata using the row’s page ID.
`NOTION_GET_ABOUT_ME`	Retrieves the bot user object associated with the current Notion integration token.
`NOTION_GET_ABOUT_USER`	Retrieves detailed information about a specific Notion user by their unique user ID.
`NOTION_GET_PAGE_PROPERTY_ACTION`	Retrieves a specific property from a Notion page using the page ID and property ID, with pagination support.
`NOTION_INSERT_ROW_DATABASE`	Creates a new page (row) in a specified Notion database with the given property values.
`NOTION_LIST_USERS`	Retrieves a paginated list of users (excluding guests) from the Notion workspace.
`NOTION_QUERY_DATABASE`	Queries a Notion database for pages (rows) with optional sorting and pagination.
`NOTION_RETRIEVE_COMMENT`	Retrieves the details of a specific comment by its ID.
`NOTION_RETRIEVE_DATABASE_PROPERTY`	Retrieves a specific property object from a Notion database by database ID and property ID.
`NOTION_SEARCH_NOTION_PAGE`	Searches Notion pages and databases by title, returning all accessible items if no query is provided.
`NOTION_UPDATE_BLOCK`	Updates the textual content or type-specific properties of an existing Notion block by its ID.
`NOTION_UPDATE_PAGE`	Updates the properties, icon, cover, or archive status of an existing Notion page.
`NOTION_UPDATE_ROW_DATABASE`	Updates or archives an existing Notion database row (page) including its icon, cover, and properties.
`NOTION_UPDATE_SCHEMA_DATABASE`	Updates an existing Notion database’s title, description, or property schema.

Available actions: ACI

Action	Description
`NOTION__GET_PAGE`	Retrieves a Notion page object using its ID, returning page properties but not page content.
`NOTION__SEARCH_PAGES`	Searches all pages shared with the integration and returns those with titles matching the query.
`NOTION__TOGGLE_PAGE_ARCHIVE`	Archives or restores a Notion page by setting its archived status to true or false.
`NOTION__RESTORE_PAGE`	Restores a Notion page from trash by setting its archived property to false.
`NOTION__LIST_USERS`	Returns a paginated list of users in the workspace, excluding guests.
`NOTION__GET_USER`	Retrieves a specific Notion user by their user ID.
`NOTION__GET_ME`	Retrieves the bot user associated with the API token provided in the authorization header.
`NOTION__CREATE_PAGE`	Creates a new page as a child of an existing page or database, with optional content blocks.

Adding to an agent

Open your agent in Agent Studio → Agent Builder
Go to Tools and enable Notion
Select only the actions your agent needs
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.

Models & LLM Providers

Tools

Data

Protocols

Setup

Composio vs ACI: Which provider to use?

Available actions: Composio

Available actions: ACI

Adding to an agent

Example use cases

​Setup

​Composio vs ACI: Which provider to use?

​Available actions: Composio

​Available actions: ACI

​Adding to an agent

​Example use cases

Setup

Composio vs ACI: Which provider to use?

Available actions: Composio

Available actions: ACI

Adding to an agent

Example use cases