Suger

Notion

Overview

Notion is a workspace for notes, docs, wikis, and databases. Connect Notion to Suger so the Suger AI agent can read and manage your Notion pages, databases, and blocks.

Org-Level vs User-Level

Org-Level: Organization-wide access via a Notion internal integration token (shown as “Notion (API Key)”). Shared across your organization.

User-Level: Personal Notion access per user via OAuth. Each user connects their own workspace.

Create Integration (Org-Level)

Prerequisites

  • A Notion internal integration and its Internal Integration Token (create at notion.so/my-integrations)
  • The Notion pages or databases you want Suger to access must be shared with that integration

Authenticate by API Key

  1. Navigate to Settings > Integrations
  2. Click Connect Notion
  3. Enter your Notion Internal Integration Token
  4. Save, then click Verify to confirm the connection

Create User Integration

  1. Click Connect Now button in the User Integrations section
  2. You will be redirected to Notion to authorize
  3. Grant access to your Notion workspace
  4. Return to Suger to confirm connection

Suger AI Tools

When Notion is connected, the Suger AI agent can read and manage your Notion workspace through Suger’s built-in tools (45 actions). Capabilities are grouped below.

Org-level and user-level: Both are supported; user-level takes precedence when both are connected.

CapabilityWhat the agent can do
PagesCreate, read, update, duplicate, move, and archive pages, including markdown export (e.g. create-page, get-page-as-markdown, archive-page)
DatabasesCreate, retrieve, and update databases and their schema (e.g. create-database, update-database, search-databases)
Database queriesRun filtered, sorted, and paginated queries (e.g. query-database, query-database-filtered, query-database-sorted)
BlocksManage page blocks and append typed content — headings, to-dos, callouts, code (e.g. append-block-children, update-block, append-todo-block)
CommentsCreate and read comment threads on pages and blocks (e.g. create-comment, list-comments)
Search & usersSearch across the workspace and look up users (e.g. search, list-users, get-account)

Edit Integration

Editing is not supported. Delete and recreate.

Delete Integration

Deleting removes the integration.

Spotted something wrong or out of date on this page? Tell us and we'll correct it.