Notion

Connect your AI agents to Notion.

Authentication: OAuth or integration token. See Magic Link for the runtime auth flow, or Application credentials to bring your own OAuth app.

Sample use cases

  • Search the Engineering Wiki for pages last edited over 60 days ago and tagged runbook for archive review.
  • Add a new entry to the Decisions Log database with today’s architecture decision.
  • Find every page in Product / Specs blocked on review and DM the reviewer.

Available Tools

append_block_children

Append child blocks to a parent block. CRITICAL: children parameter must be native JSON array of block objects, NOT strings. Use [{“object”: “block”, “type”: “paragraph”, …}] format.

get_block

Retrieve a block by ID

get_block_children

Retrieve children of a block with pagination

update_block

Update a block’s content or properties. CRITICAL: All block properties must be native JSON objects, NOT strings. Use proper block type structure.

delete_block

Delete a block

create_comment

Create a comment on a page or block

list_comments

List comments for a block or get ALL comments from an entire page

create_database

Create a new database in Notion with specified schema, properties, and parent page. Requires properly structured parent object with type field and valid page_id.

query_database

Query a database with filtering, sorting, and pagination.

get_database

Retrieve a database by ID

update_database

Update database properties, title, description, icon, cover, and schema

create_page

Create a new page in Notion under an existing page or database.

get_page

Retrieve a page by ID

get_page_property

Retrieve a specific page property

update_page

Update page properties, icon, cover, or archive status

archive_page

Archive a page (move to trash)

search

Search for pages and databases by title

list_users

List all users in the workspace

get_user

Retrieve a user by ID

get_bot_user

Retrieve the current integration’s bot user