Notion MCP by InsightfulPipe

MCP Compatible Insightful Pipe License

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

1. Copy the MCP Server URL: https://notion.insightfulmcp.com/
2. Open Claude Connectors Settings
3. Scroll to the bottom and click Add custom connector
4. Paste the URL and click Add
5. 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.

1. Turn on Developer mode in ChatGPT settings
2. Create a new app for a remote MCP server and paste the URL: https://notion.insightfulmcp.com/
3. 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.

• Airtable MCP
• Google Sheets MCP
• Slack MCP

View All MCP Servers →

Resources

• Documentation
• Video Tutorial
• InsightfulPipe Blog

Support

• Documentation: insightfulpipe.com/docs
• All MCP Servers: insightfulpipe.com/mcp-servers
• Email: [email protected]

---

Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →

License

MIT License - see LICENSE for details.