Notion MCP by InsightfulPipe
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http notion-mcp-by-insightfulpipe 'https://notion.insightfulmcp.com/'{
"mcpServers": {
"notion-mcp-by-insightfulpipe": {
"type": "http",
"url": "https://notion.insightfulmcp.com/"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Notion MCP Server by Insightful Pipe
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).
MCP Server URL
https://notion.insightfulmcp.com/What is Notion MCP?
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.
Installation
Claude
- 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 and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.
ChatGPT
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/ - Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.
See OpenAI's guide: Developer mode and MCP apps in ChatGPT
Claude Code
claude mcp add --transport http notion https://notion.insightfulmcp.com/Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"notion": {
"url": "https://notion.insightfulmcp.com/"
}
}
}When Cursor shows Needs authentication, click Connect and sign in to InsightfulPipe if asked.
Available Actions
23 actions: 13 read, 10 write.
Read Actions (13)
| 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 |
Write Actions (10)
| 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 |
Control What Your AI Can Do
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.
Usage Examples
"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"Pricing
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, and you can try it for 7 days. See insightfulpipe.com/pricing for current plans.
Explore More MCP Servers by Insightful Pipe
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers.
Resources
Support
- 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 →
License
MIT License - see LICENSE for details.
Frequently asked questions
What is Notion MCP by InsightfulPipe?
Hosted Notion MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
How do I install Notion MCP by InsightfulPipe?
It runs as a remote server. In Claude Code: claude mcp add --transport http notion-mcp-by-insightfulpipe 'https://notion.insightfulmcp.com/'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Notion MCP by InsightfulPipe need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Notion MCP by InsightfulPipe open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Notion MCP by InsightfulPipe?
It is published by Insightful-Pipe. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.