Notion
Search, read, and update Notion pages and data sources shared with your workspace.
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
- Sign in to stackgate.ai.
- Go to Integrations and open Notion.
- Click Activate, then Connect Notion.
- 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/notionwith 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.