Skip to main content

Notion

Comprehensive Notion connector for managing databases, pages, blocks, users, and content operations.

What you can ask​

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

Set up​

Notion connects with credentials from your Notion account. Have these values ready:

  • Integration token
  1. Go to Organization > Connectors and find Notion.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Notion offers 22 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (13)​

View and search information without changing it.

ToolWhat it does
get_blockRetrieve a block by ID
get_block_childrenRetrieve children of a block with pagination
get_bot_userRetrieve the current integration's bot user
get_data_sourceRetrieve a data source and its property schema.
get_databaseRetrieve a database container by ID: title, parent, and the data_sources it holds.
get_pageRetrieve a page by ID
get_page_propertyRetrieve a specific page property.
get_userRetrieve a user by ID
list_commentsList comments for a block or get ALL comments from an entire page
list_usersList all users in the workspace
query_databaseQuery the pages in a database or data source, with filtering, sorting and pagination.
searchSearch pages and data sources by title or body content.
validate_credentialValidate Notion credentials by fetching the bot user.

Write (4)​

Create or send data.

ToolWhat it does
append_block_childrenAppend child blocks to a page or block. position accepts only type after_block, start or end.
create_commentCreate a comment on a page or block, or reply to an existing thread by passing discussion_id from list_comments.
create_databaseCreate a database under a page. properties defines the initial data source schema; title and description are rich text arrays.
create_pageCreate a page under an existing page or database; workspace-level pages are not supported.

Delete or overwrite (5)​

Remove or replace existing data.

ToolWhat it does
archive_pageArchive a page (move to trash)
delete_blockDelete a block
update_blockUpdate a block's content or archive status.
update_databaseUpdate a database's title, description, icon, cover, or property schema. title and description are rich text arrays.
update_pageUpdate a page's properties, icon, cover, or archive status, e.g. properties {"Status": {"select": {"name": "Done"}}}.
⌘J