Notion

The Notion connector indexes pages — titles and full page bodies — into the local SQLite index and exposes read tools for pages, databases, blocks, and comments, plus four HITL-gated write tools for creating pages, appending blocks, and posting comments.

---

What’s indexed

• Service id: notion
• Item types: page
• Body: the page’s block text, up to 16,384 UTF-16 code units. Fetching a body costs an extra API call per page, so an initial workspace sync is meaningfully slower and more quota-hungry than a title-only one.

A page whose body fetch fails is not retried automatically

If a page’s block fetch errors (a 403 on a page the integration cannot read, say), the page is still indexed — with its title and no body — and the sync watermark still advances past it. That is deliberate: pinning the watermark below one permanently-unreadable page would re-walk the entire workspace on every sync, forever. Such a page is re-examined only when it is edited again in Notion, or when you run nimbus index rebody --service notion to clear the watermark and force a full re-walk.

Indexing depth is enforced on every sync, not just at reindex time. See Indexing depth.

Authenticate

nimbus connector auth notion

OAuth (Notion). The Gateway resolves a Bearer access token via the Notion OAuth flow (refreshed via getValidNotionAccessToken) and injects it into the connector spawn as NOTION_ACCESS_TOKEN.

Read tools (no HITL)

Tool	Purpose
notion_block_children	List child blocks of a block or page.
notion_comment_list	List comments for a block or page.
notion_database_list	Search Notion databases (POST /v1/search, object filter database).
notion_database_query	Query a Notion database.
notion_page_get	Retrieve a Notion page and its direct child blocks.
notion_page_list	Search Notion pages the integration can access (POST /v1/search, object filter page).

Write tools (HITL-gated)

Every tool below requires interactive consent through the Gateway HITL gate before it executes.

Tool	Purpose
notion_block_append	Append blocks to a parent block. childrenJson is a JSON array of block objects.
notion_comment_create	Create a comment thread on a page.
notion_page_create	Create a page under a parent page.
notion_page_update	Update page properties. Pass properties JSON as a string.

See also

• Connectors overview
• HITL and safety