All integrations

Notion

Search, read, and update Notion pages and data sources shared with your workspace.

OAuth 12 tools

Overview

Connect Notion to give AI clients access to pages and data sources you share during authorization.

Prerequisites

  • A Notion account with pages or databases you want AI to access
  • A stackgate.ai account

Getting credentials

  1. Sign in to stackgate.ai.
  2. Go to Integrations and open Notion.
  3. Click Activate, then Connect Notion.
  4. In Notion's page picker, select the pages and databases AI should access, then click Allow access.

No manual API keys are required. To grant access to additional pages later, disconnect and reconnect Notion.

Using with AI clients

  • Dedicated endpoint: POST /mcp/notion with a Sanctum bearer token
  • Private gateway: one config for all integrations — use notion__* namespaced tools

See Documentation for HTTP authentication and private gateway setup.

Troubleshooting

  • 422 integration not configured — complete the OAuth connect flow in My Integrations.
  • Object not found — the page or database was not shared during connect. Reconnect and select it in Notion's page picker.
  • Token expired — disconnect and reconnect Notion from the integration page.

Available tools

  • search-tool

    Search pages and data sources shared with the connected Notion workspace by title.

  • get-page-tool

    Retrieve a Notion page by ID, including properties and metadata.

  • list-block-children-tool

    List child blocks of a page or block. Use the page ID as block_id for top-level content.

  • get-data-source-tool

    Retrieve a Notion data source (database) schema and metadata by ID.

  • query-data-source-tool

    Query rows in a Notion data source with optional filter and sort.

  • list-users-tool

    List users in the connected Notion workspace.

  • get-user-tool

    Retrieve a Notion user by ID.

  • create-page-tool

    Create a new Notion page under a page or data source parent.

  • update-page-tool

    Update a Notion page properties or archive it.

  • append-blocks-tool

    Append block children to a page or block.

  • update-block-tool

    Update a Notion block content or archive it.

  • delete-block-tool

    Archive (delete) a Notion block.

MCP endpoint: https://stackgate.ai/mcp/notion (HTTP) or via the private gateway.