Question 1

What is Notion MCP?

Accepted Answer

It's an MCP (Model Context Protocol) server that connects Notion to your AI, giving the agent tools to act on your data, through a single remote link.

Question 2

Which AI clients does it work with?

Accepted Answer

Any MCP-compatible client: Claude (web, desktop and mobile), Cursor, ChatGPT with connectors, OpenClaw and other agents.

Question 3

Do I need to code?

Accepted Answer

No. Paste the remote URL into your client, authenticate once, and you're done. No packages to install, no code to write.

Question 4

Is it secure? Can the AI change my data?

Accepted Answer

Access is authorized by you and can be revoked anytime. Permissions follow what Notion exposes; you approve them when connecting.

Question 5

Is my customers' data stored on mcp.ai?

Accepted Answer

No. Whatever Notion returns passes through our infrastructure solely to reach the AI assistant you chose, and that content is not stored. By design we don't persist tool-call payloads: the log keeps metadata only (which tool, timestamp, status, duration, size and a hash of the arguments). Your credentials are stored encrypted and you can revoke the connection at any time. Retention periods and details are in the Privacy Policy at mcp.ai/privacy.

Question 6

Is my data used to train AI models?

Accepted Answer

No. Nothing that flows through the connector is used to train or improve AI models, nor shared with third parties for that purpose. The conversation itself, meaning your prompts and the AI's answers, is processed by the AI provider you choose (Claude, ChatGPT and the like), under their own privacy policy.

Question 7

How much does it cost?

Accepted Answer

You start free and upgrade when you need more usage. Billing and limits are managed in your mcp.ai account.

Question 8

Can I cancel anytime?

Accepted Answer

Yes. Plans are monthly and can be cancelled at any time, with no lock-in.

Notion

Tools (28)

API & agent docs

Frequently asked questions

Example prompts

Notion

Tools (28)

notion_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 pars

notion_add_page_contentDeprecated: appends a single content block to a notion page or a parent block (must be page, toggle, to-do, bulleted/numbered list, callout, or quote); invoke repeatedly to add multiple blocks.

notion_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

notion_archive_notion_pageArchives (moves to trash) or unarchives (restores from trash) a specified notion page.

notion_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).

notion_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.

notion_create_notion_pageCreates a new empty page in a notion workspace.

notion_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.

notion_duplicate_pageDuplicates a notion page, including all its content, properties, and nested blocks, under a specified parent page or workspace.

notion_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 dee

notion_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.

notion_fetch_commentsFetches unresolved comments for a specified notion block or page id.

notion_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

notion_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.

notion_fetch_rowRetrieves a notion database row's properties and metadata; use fetch block contents for page content blocks.

notion_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.

notion_get_about_userRetrieves detailed information about a specific notion user, such as their name, avatar, and email, based on their unique user id.

notion_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.

notion_insert_row_databaseCreates a new page (row) in a specified notion database.

notion_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`.

notion_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.

notion_retrieve_commentTool to retrieve a specific comment by its id. use when you have a comment id and need to fetch its details.

notion_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.

notion_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.

notion_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`.

notion_update_pageTool to update the properties, icon, cover, or archive status of a page. use when you need to modify existing page attributes.

notion_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 (n

notion_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.