Notion MCP server for Claude, ChatGPT, Claude Code and Cursor

How to connect Notion

1. 1
   Click Connect Notion free and sign in to Notion.
2. 2
   Add ContextGate to your AI app:

   ClaudeChatGPTClaude CodeCursorGitHub CopilotCodexGemini CLIOther

   1. 1

      In Claude, open Settings → Connectors and click Add custom connector.

   2. 2

      Name it ContextGate and paste this URL:

      https://api.contextgate.ai/mcp

   3. 3

      Click Add, then Connect, and sign in to ContextGate.

   4. 4

      In a chat, turn ContextGate on from the + menu → Connectors. Cowork and the desktop app use the same connectors.

   The full Claude guide

   1. 1

      In ChatGPT settings, open Apps & Connectors (or Connectors) → Advanced and turn on Developer mode.

   2. 2

      Create a connector, choose OAuth, and paste this URL:

      https://api.contextgate.ai/mcp

   3. 3

      Sign in to ContextGate when ChatGPT redirects you, then pick the connector in a chat.

   The full ChatGPT guide

   1. 1

      Run this in a terminal:

      claude mcp add --transport http contextgate https://api.contextgate.ai/mcp

   2. 2

      Start Claude Code, run /mcp, choose contextgate and sign in to ContextGate.

   The full Claude Code guide

   Add to Cursor

   1. 1

      Click Add to Cursor, or add this to ~/.cursor/mcp.json:

      {
        "mcpServers": {
          "contextgate": {
            "url": "https://api.contextgate.ai/mcp"
          }
        }
      }

   2. 2

      In Cursor Settings → MCP, sign in to ContextGate when Cursor asks.

   The full Cursor guide

   Add to VS Code

   1. 1

      Click Add to VS Code, or add this to .vscode/mcp.json:

      {
        "servers": {
          "contextgate": {
            "type": "http",
            "url": "https://api.contextgate.ai/mcp"
          }
        }
      }

   2. 2

      Start the server when VS Code asks, sign in to ContextGate, and use it from Copilot Chat in Agent mode.

   The full GitHub Copilot guide

   1. 1

      Run this in a terminal:

      codex mcp add contextgate --url https://api.contextgate.ai/mcp

   2. 2

      Then sign in to ContextGate:

      codex mcp login contextgate

   The full Codex guide

   1. 1

      Run this in a terminal:

      gemini mcp add --transport http contextgate https://api.contextgate.ai/mcp

   2. 2

      In Gemini CLI, run /mcp auth contextgate and sign in to ContextGate.

   The full Gemini CLI guide

   1. 1

      Add a remote (HTTP) MCP server with this URL:

      https://api.contextgate.ai/mcp

   2. 2

      Apps that support MCP sign-in ask you to sign in to ContextGate the first time they connect.

   3. 3

      An app that can't sign in can use a workspace API key instead: create one under API keys and add ?api_key=<your key> to the URL.

   More on adding it to any MCP app
3. 3
   Ask your AI app to use Notion, then open Activity to see the call.

Notion's own MCP server

• ContextGate now connects to Notion's own MCP server by default: in Add Connection, search for Notion and sign in with your Notion account. There's nothing to copy or paste.
• ContextGate's app connector for Notion is still there, under Ways to connect on the same card.
• Whichever way you connect, your tool switches, policies and Activity work the same.

What you get with Notion and ContextGate

• Your AI apps can use NotionClaude, Cursor, ChatGPT and other AI apps reach Notion through the one ContextGate connection you add to them.
• You choose which tools they can useSwitch off any Notion tool you don't want used. It's hidden from your AI apps and refused if called.
• Every call is checked and recordedYour policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.

ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.

Notion tools

Examples of what your AI apps can do in Notion. You'll see the exact list of tools after you connect it.

• append_block_childrenAppends complex blocks with full notion block structure to a parent block or page. use for advanced scenarios requiring precise control: code blocks, tables, embeds, nested children within blocks, or when working with pre-built notion block objects. requires full notion api block schema - use add multiple page content for simpler content creation.
• update_pageTool to update the properties, icon, cover, or archive status of a page. use when you need to modify existing page attributes.
• add_multiple_page_contentEfficiently adds multiple standard content blocks to a notion page in a single api call with automatic markdown parsing. the 'content' field in notionrichtext blocks now automatically detects and parses markdown formatting including headers (# ## ###), bold (**text**), italic (*text*), strikethrough (~~text~~), inline code (`code`), links ([text](url)), and more. ideal for bulk content creation, ai agents, and replacing multiple individual add page content calls. supports automatic text formatting, content splitting, and up to 100 blocks per request.
• create_commentAdds a comment to a notion page (via `parent page id`) or to an existing discussion thread (via `discussion id`); cannot create new discussion threads on specific blocks (inline comments).
• create_databaseCreates a new notion database as a subpage under a specified parent page with a defined properties schema; use this action exclusively for creating new databases.
• create_notion_pageCreates a new empty page in a notion workspace.
• delete_blockArchives a notion block, page, or database using its id, which sets its 'archived' property to true (like moving to "trash" in the ui) and allows it to be restored later.
• fetch_block_contentsRetrieves a paginated list of direct, first-level child block objects along with contents for a given parent notion block or page id; use block ids from the response for subsequent calls to access deeply nested content.
• fetch_commentsFetches unresolved comments for a specified notion block or page id.
• fetch_databaseFetches a notion database's structural metadata (properties, title, etc.) via its `database id`, not the data entries; `database id` must reference an existing database.
• fetch_rowRetrieves a notion database row's properties and metadata; use fetch block contents for page content blocks.
• get_about_meRetrieves the user object for the bot associated with the current notion integration token, typically to obtain the bot's user id for other api operations.
• get_about_userRetrieves detailed information about a specific notion user, such as their name, avatar, and email, based on their unique user id.
• insert_row_databaseCreates a new page (row) in a specified notion database.
• list_usersRetrieves a paginated list of users (excluding guests) from the notion workspace; the number of users returned per page may be less than the requested `page size`.
• query_databaseQueries a notion database for pages (rows), where rows are pages and columns are properties; ensure sort property names correspond to existing database properties.
• retrieve_commentTool to retrieve a specific comment by its id. use when you have a comment id and need to fetch its details.
• retrieve_database_propertyTool to retrieve a specific property object of a notion database. use when you need to get details about a single database column/property.
• search_notion_pageSearches notion pages and databases by title; an empty query lists all accessible items, useful for discovering ids or as a fallback when a specific query yields no results.
• update_row_databaseUpdates or archives an existing notion database row (page) using its `row id`, allowing modification of its icon, cover, and/or properties; ensure the target page is accessible and property details (names/ids and values) align with the database schema and specified formats.
• update_schema_databaseUpdates an existing notion database's title, description, and/or properties; at least one of these attributes must be provided to effect a change.
• archive_notion_pageArchives (moves to trash) or unarchives (restores from trash) a specified notion page.
• duplicate_pageDuplicates a notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace.
• fetch_block_metadataFetches metadata for a notion block (or page, as pages are blocks) using its valid uuid; if the block has children, use fetch block contents to fetch their contents.
• fetch_dataFetches notion items (pages and/or databases) from the notion workspace, use this to get minimal data about the items in the workspace with a query or list all items in the workspace with minimal data
• get_page_property_actionCall this to get a specific property from a notion page when you have a valid `page id` and `property id`; handles pagination for properties returning multiple items.
• update_blockUpdates an existing notion block's textual content or type-specific properties (e.g., 'checked' status, 'color'), using its `block id` and the specified `block type`.