Notion MCP server

Read from the package source without running it. The installed server may list more.

• notion_add_comment

  Start a new comment discussion on a block. If `anchor_text` is provided, the comment is anchored inline to that exact substring of the block's text (the Notion UI highlights it yellow). Without `anchor_text`, the discussion attaches at the block level. Supports markdown **bold**, *italic*, `code`, and [links](url) in the comment body.

• notion_add_image

  Add an image to the END of a Notion page. `image_path` is either an absolute path to a local image file (uploaded to Notion) or an http(s) URL (referenced as an external image). Non-destructive — appended after existing blocks.

• notion_append_to_page

  Append markdown content to the END of a Notion page, after the existing blocks. Non-destructive — existing content is left untouched. Supports headings, lists, to-do checkboxes, code blocks, tables, and inline formatting (bold, italic, strikethrough, code, links).

• notion_append_to_page_from_file

  Append a local markdown file to the END of a Notion page, after the existing blocks. Non-destructive — existing content is left untouched.

• notion_create_pagewrite action

  Create a new Notion page as a child of an existing page. Optionally populate it with markdown content. Returns the URL of the created page.

• notion_create_page_from_filewrite action

  Create a new Notion page and populate it from a local markdown file. Returns the URL of the created page.

• notion_export_page

  Export a Notion page as clean markdown. Converts headings, lists, code blocks, tables, bold/italic, links, images, and nested content into standard markdown. Image links resolve to viewable URLs; pass image_dir to download images locally and link to the files instead.

• notion_import_pagewrite action

  Write markdown content to a Notion page. DESTRUCTIVE: replaces ALL existing blocks on the page with content parsed from the markdown string. To add content without removing what is already there, use notion_append_to_page instead. Supports headings, lists, to-do checkboxes, code blocks, tables, and inline formatting (bold, italic, strikethrough, code, links).

• notion_import_page_from_filewrite action

  Write a local markdown file to a Notion page. DESTRUCTIVE: reads the file and replaces ALL existing page blocks with the parsed content. To add content without removing what is already there, use notion_append_to_page_from_file instead.

• notion_init

  Set up Notion credentials by pasting a "Copy as cURL" of any notion.so/api/v3 request from your browser DevTools (Network tab → right-click a request → Copy as cURL). Extracts the token/user/workspace and saves them to ~/.notion-mcp/config.json. If you have multiple workspaces, it lists them — call again with space_id. Runs without existing credentials.

• notion_list_comments

  List all open comment discussions on a page (and its child blocks). Returns discussion IDs, anchored text context, authors, timestamps, and comment bodies. Use this to read feedback/review threads on any page.

• notion_reply_comment

  Reply to an existing comment discussion thread. Use the discussion ID returned from notion_list_comments or notion_add_comment.

• notion_search

  Full-text search across all pages in your Notion workspace. Returns page titles, IDs, and last edited timestamps. Searches everything you can see in the browser — no need to explicitly share pages.

• Code scan2 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 95 days ago8/15
• Maintainer identityregistry namespace matches repository owner7/10

Safety score

71/100

higher than 32% of 1,299 Productivity servers

Tools

13

the typical Productivity server has 7

Tools that change things

31%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

2

more than 60% of 854 Productivity servers

Downloads a week

36

more than 23% of 427 Productivity servers with a package

Notion: common questions

Is Notion MCP server safe?

Mostly: it is graded B (71/100). Read the Notion safety report

How do I install Notion?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Notion need an API key?

Yes. The registry entry asks for NOTION_TOKEN.

Is Notion maintained?

The last commit was 134 days ago (2026-06-23). The latest release is v0.5.2.

What can I use instead of Notion?

Servers from other publishers that do the same job: Better Notion MCP server, Remnus MCP server and Easy Notion MCP server.

How does Notion compare with other Productivity MCP servers?

safety score 71/100 (higher than 32% of 1,299 Productivity servers); tools 13 (the typical Productivity server has 7); tools that change things 31% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.