Notion MCP connector

What agents can do

The server has 23 actions (13 read, 10 write).

• Search and pages: search finds shared pages and data sources, and get_page and get_page_property read pages and their properties.
• Page content: get_block and get_block_children read the blocks that make up a page.
• Databases: get_database, get_data_source, query_data_source with filters and sorts, and list_data_source_templates.
• Comments and people: get_comments, list_users, get_user and get_self.
• Create and edit pages: create_page under a page or in a database, update_page for properties, icons and covers, and move_page.
• Edit content: append_block_children, update_block and delete_block.
• Build databases: create_database, create_data_source and update_data_source for titles and schemas.
• Comment: create_comment.

Before you connect

• A Notion account in the workspace you want to connect, with access to the pages agents should use.
• An InsightfulPipe workspace with a brand for the Notion workspace. Owners, admins and operators can add connections.

Connect Notion

1. In the InsightfulPipe app, open Connectors, choose Notion and click Connect.
2. Under Permissions, choose Read Only or Read + Write.
3. Click Connect to Notion.
4. In Notion, choose the pages to share with the integration and allow access.

Add the MCP server to your AI client

Server URL: https://notion.insightfulmcp.com/ and server name: notion-mcp.

• Claude: open Claude Connectors Settings, scroll to the bottom and click Add custom connector, paste the URL, click Add, then click Connect.
• ChatGPT: in ChatGPT Security Settings turn on Developer mode, click Create on the Connectors page, paste the URL, click Create, then click Connect. Turn the connector on in each new chat with + → More.
• Claude Code: run claude mcp add --transport http notion-mcp https://notion.insightfulmcp.com/, then type /mcp, select notion-mcp and click Authenticate.
• Cursor: in the app, open MCP Servers, choose Notion and click Install Notion MCP, click Open Cursor then Install, then click Connect and Open.
• Gemini CLI: run gemini mcp add --transport http notion-mcp https://notion.insightfulmcp.com/, then /mcp auth notion-mcp.
• Codex CLI: run codex mcp add notion-mcp --url https://notion.insightfulmcp.com/; authorization starts automatically.

Each client opens a browser window where you log in to InsightfulPipe and click Authorize access. Step-by-step guides: Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex CLI. To reach every connected platform through one server, use the unified server.

Permissions and safety

• Read Only connections use a separate Notion integration without write capabilities, so every write is locked. Writes need Read + Write.
• delete_block archives a block. It is destructive, so it stays off until an owner, admin or operator enables it in Configure actions for this account.
• update_page and update_block can also archive content, and they are regular write actions that are on for Read + Write connections. Turn them off where agents should not remove content.
• Writes need the Owner, Administrator or Operator role. Members with the User role can only run enabled read actions on accounts granted to them.

Limits

• Agents only see pages and databases shared with the integration, and the content inside them.
• Deleting archives content rather than removing it permanently.
• There are no actions for uploading files, duplicating pages or creating database views.
• Notion API rate limits apply. A rate-limited request returns an error for the agent to retry.

Example prompts

• "Using Notion, find our Q3 marketing plan and summarize it."
• "Show tasks in Content Calendar due this week that aren't done."
• "Add a page to the Tasks database for each action item in these notes."
• "Append a Results section with these bullet points to the launch page."

Troubleshooting

• The agent can't find a page: share the page, or a parent page, with the InsightfulPipe integration in Notion, then ask again.
• "This action is disabled for this connected account. An owner or admin must enable it for the account." An owner, admin or operator can enable it in Configure actions for this account.
• "This account is connected read-only, so this action cannot be enabled for it. An owner or admin must reconnect it with Read & Write permissions." Reconnect and choose Read + Write under Permissions.
• Rate limit errors: wait a moment, then ask the agent to retry or request fewer pages at once.

FAQ

Which Notion pages can the agent see?

Only the pages and databases you shared with the integration when you connected, and the content inside them.

Is this Notion's official MCP server?

No. Notion runs its own hosted MCP server. InsightfulPipe is an independent hosted server with Read Only connections through a separate read-only integration, per-action controls and your other platforms in the same workspace.

Can I connect several Notion workspaces?

Yes. Each connection is one Notion workspace, and each connected workspace counts as one connection on your plan.

Related

• Notion MCP server
• Airtable connector
• Slack connector
• Workspace roles and permissions
• MCP troubleshooting