Connect Notion to AI assistants: pages, databases, data sources and blocks.
Part of the Insightful Pipe MCP Server Collection — use Notion from Claude, ChatGPT, Cursor, and other AI assistants through the Model Context Protocol (MCP).
https://notion.insightfulmcp.com/
Notion MCP is a remote Model Context Protocol server hosted by InsightfulPipe. Search and read Notion pages, databases, and data sources, retrieve block trees, query data-source rows, and (with read+write scopes) create or update pages and blocks. The OAuth scopes you granted at connect time decide what's allowed.
- Copy the MCP Server URL:
https://notion.insightfulmcp.com/ - Open Claude Connectors Settings
- Scroll to the bottom and click Add custom connector
- Paste the URL and click Add
- Click Connect on the connector to start authorization
- Click Authorize access in the browser to complete the connection
Custom MCP servers are added through ChatGPT's Developer mode. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.
- Turn on Developer mode in ChatGPT settings
- Create a new app for a remote MCP server and paste the URL:
https://notion.insightfulmcp.com/ - Authorize with your InsightfulPipe account
See OpenAI's guide: Developer mode and MCP apps in ChatGPT
claude mcp add --transport http notion https://notion.insightfulmcp.com/Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"notion": {
"url": "https://notion.insightfulmcp.com/"
}
}
}Then authorize the connection when Cursor prompts you.
23 actions: 13 read, 10 write.
| Action | Description |
|---|---|
get_block |
Retrieve a block by ID |
get_block_children |
List children of a block (e.g. paragraphs inside a page) |
get_comments |
List comments on a page or block |
get_data_source |
Retrieve a data source |
get_database |
Retrieve a database (legacy endpoint) |
get_page |
Retrieve a page by ID |
get_page_property |
Retrieve a single property item on a page |
get_self |
Retrieve the integration's bot user (token owner) |
get_user |
Retrieve a single user by their Notion user ID |
list_data_source_templates |
List templates available in a data source |
list_users |
List all users in the workspace |
query_data_source |
Query a data source (filter + sort + paginate) |
search |
Search pages and data sources visible to the integration |
| Action | Description |
|---|---|
append_block_children |
Append new child blocks to an existing block |
create_comment |
Add a comment to a page or discussion thread |
create_data_source |
Add a new data source to an EXISTING database |
create_database |
Create a brand-new database with an initial data source under a parent page |
create_page |
Create a new page under a parent page or database |
delete_block |
Archive (soft-delete) a block |
move_page |
Move a page to a new parent |
update_block |
Update a block's content or archived state |
update_data_source |
Update a data source's title or schema |
update_page |
Update a page's properties / icon / cover, or archive/unarchive it |
You decide what AI agents can do with each connected account:
- Turn individual actions on or off for every connected account, so agents only see the actions you allow.
- Connect as Read-only or Read & Write. A read-only connection can only enable read actions.
- Destructive actions stay off by default. Actions such as deletes are disabled until an admin enables them.
- Team access per account. Restricted team members only use the accounts they are granted, with the read actions enabled on them.
"Search my workspace for pages about Q4 planning"
"Show items in the Content Calendar database due this week"
"Create a page with this week's campaign notes"
The Notion MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month with a 7-day free trial. See insightfulpipe.com/pricing for current plans.
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers.
- Documentation: insightfulpipe.com/docs
- All MCP Servers: insightfulpipe.com/mcp-servers
- Email: support@insightfulpipe.com
Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →
MIT License - see LICENSE for details.