Skip to main content
Connect your Notion workspace and unlock these capabilities: search and read pages, query and update databases, manage blocks and content, and give AI agents full access to your workspace structure — all through a native MCP OAuth connection.

​
What you unlock

Page and database access

Search, read, and create pages across your entire Notion workspace without switching tabs.

Database queries

Query Notion databases with filters, read structured data, and update records directly from your agent.

Content management

Create and edit blocks, manage page content, and organize your workspace structure programmatically.

MCP-native connection

Notion uses MCP OAuth — the MCP server handles its own authentication flow, so setup is seamless.

​
Connect Notion

1

Open Settings → Integrations

In any workspace go to Settings → Integrations and select Notion.
2

Authorize with Notion

Click Connect — Notion’s MCP server handles the OAuth flow automatically. You’ll be redirected to Notion to authorize access to your workspace. Select the pages and databases you want to share, then confirm.
3

Start using Notion in agents

Once connected, any agent in your workspace can search pages, query databases, and create content in Notion.

​
Agent tools

Notion tools are provided by the MCP server and discovered dynamically at connection time. The following are the core capabilities available.

​
Pages

ToolDescription
Search pagesSearch for pages and databases across your workspace
Read pageRetrieve the full content of a page by ID
Create pageCreate a new page in a database or as a child page
Update pageUpdate page properties and content

​
Databases

ToolDescription
Query databaseQuery a database with filters and sorts
Create databaseCreate a new database with a defined schema
Update databaseUpdate database properties and schema

​
Blocks

ToolDescription
Read blocksRetrieve child blocks of a page or block
Append blocksAdd new content blocks to a page
Update blockUpdate the content of an existing block
Delete blockArchive or delete a block

​
Comments

ToolDescription
List commentsRetrieve comments on a page or block
Create commentAdd a new comment to a page or discussion

​
Triggers

Triggers are not yet available for Notion. Tools are fully supported — connect and start using them in any agent.

​
Example use cases

Connect Notion and let your agent search across wiki pages and databases. Ask a question in chat, and the agent finds the relevant Notion page, reads the content, and provides an answer with a direct link.
After a discussion in chat, ask your agent to create a new Notion page with a structured summary — attendees, decisions, and action items — and place it in the right database automatically.
Query a Notion project tracker database, summarize the current status of open tasks, and post a digest to your team channel — all without leaving Mantle.

​
Troubleshooting

Make sure pop-ups are not blocked in your browser. The MCP OAuth flow opens a Notion authorization page — if it’s blocked, the connection can’t complete. Try again with pop-ups allowed.
During the OAuth flow, Notion asks which pages and databases to share. If a page is missing, go to Settings → Integrations → Notion, disconnect, and reconnect — this time selecting the additional pages.
Your Notion authorization may have expired or been revoked. Go to Settings → Integrations → Notion and reconnect to re-authorize.
Check that the database was shared during the OAuth authorization step. Also verify that your filter criteria match existing records — try a broader query first to confirm access.

Back to Integrations

View all available integrations