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

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

  • get_page

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

  • list_block_children

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

  • get_data_source

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

  • query_data_source

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

  • list_users

    List users in the connected Notion workspace.

  • get_user

    Retrieve a Notion user by ID.

  • create_page

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

  • update_page

    Update a Notion page properties or archive it.

  • append_blocks

    Append block children to a page or block.

  • update_block

    Update a Notion block content or archive it.

  • delete_block

    Archive (delete) a Notion block.

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