Notion
The Notion connector lets AI agents search your workspace, read pages and databases, create new pages, and update properties — all through the official Notion API using OAuth 2.0. Your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.
Required scopes#
Notion uses OAuth 2.0. When you connect, MCPGate requests access to your Notion workspace via the official OAuth consent screen. The integration will request the following capabilities:
| Capability | Purpose |
|---|---|
| Read content | Search pages and databases, read page and database contents |
| Update content | Create and update pages |
| Insert content | Create pages in databases |
Note
Delete archives, not permanently removes
notion_delete_page archives the page in Notion — it does not permanently delete it. Archived pages can be restored from the Notion trash within 30 days.Tool reference#
The Notion connector exposes 7 tools: 4 read, 2 write, and 1 delete.
| Tool | Category | Description |
|---|---|---|
| notion_search | read | Search pages and databases in Notion |
| notion_get_page | read | Get a Notion page by ID |
| notion_get_database | read | Get a Notion database by ID |
| notion_query_database | read | Query rows from a Notion database |
| notion_create_page | write | Create a new page in Notion |
| notion_update_page | write | Update a page's properties |
| notion_delete_page | delete | Archive/delete a page |
Common guardrail recipes#
Read-only access#
Enable only the four read tools and deny notion_create_page, notion_update_page, and notion_delete_page. Ideal for agents that generate summaries or answer questions from your Notion knowledge base.
Block page deletion#
Deny notion_delete_page while keeping read and write tools enabled. This prevents the AI from archiving pages, while still allowing it to create and update content.
Restrict to specific databases#
Apply the allow_values template to notion_query_database and notion_create_page, targeting the database_id or parent.database_id field. This limits the AI to only the databases you explicitly allow.
Troubleshooting#
- Page not found— Notion pages must be explicitly shared with the MCPGate integration in your Notion workspace settings. Open the page in Notion and use the "Connect to" option to grant access.
- Database query returns no rows — Check that the database has been shared with the integration and that filter criteria in
notion_query_databasematch existing property values. - Property update ignored —
notion_update_pageonly updates properties that exist in the page's schema. Ensure property names match exactly, including capitalisation.