servers / notionhq-notion-mcp-server

@notionhq/notion-mcp-server

communityunknownnpmdestructive capablehealthy

Official MCP server for Notion API

Featured profile Pricing Is it safe?Setup guide Alternatives Claim this server

01Tools · 24

How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.

Tool	Risk	Side effects	Approval
API-post-search Notion \| Search by title Error Responses: 400: Bad request	write	true	unknown
API-retrieve-a-data-source Notion \| Retrieve a data source Error Responses: 400: Bad request	unknown	unknown	unknown
API-update-page-markdown Notion \| Update a page's content as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 409: Conflict (e.g. row limit exceeded). 429: Rate limited.	write	true	unknown
API-move-page Notion \| Move a page Error Responses: 400: Bad request	write	true	unknown
API-retrieve-a-block Notion \| Retrieve a block Error Responses: 400: Bad request	unknown	unknown	unknown
API-retrieve-a-database Notion \| Retrieve a database Error Responses: 400: Bad request	unknown	unknown	unknown
API-update-a-block Notion \| Update a block Error Responses: 400: Bad request	write	true	unknown
API-retrieve-a-comment Notion \| Retrieve comments Error Responses: 400: Bad request	write	true	unknown
API-get-user Notion \| Retrieve a user Error Responses: 400: 400	read	false	unknown
API-patch-page Notion \| Update page properties Error Responses: 400: Bad request	write	true	unknown
API-get-users Notion \| List all users Error Responses: 400: 400	read	false	unknown
API-post-page Notion \| Create a page Error Responses: 400: Bad request	write	true	unknown
API-query-data-source Notion \| Query a data source Error Responses: 400: Bad request	read	false	unknown
API-create-a-comment Notion \| Create comment Error Responses: 400: Bad request	write	true	unknown
API-create-a-data-source Notion \| Create a data source Error Responses: 400: Bad request	write	true	unknown
API-get-block-children Notion \| Retrieve block children Error Responses: 400: Bad request	read	false	unknown
API-get-self Notion \| Retrieve your token's bot user Error Responses: 400: Bad request	read	false	unknown
API-patch-block-children Notion \| Append block children Error Responses: 400: Bad request	write	true	unknown
API-delete-a-block Notion \| Delete a block Error Responses: 400: Bad request	destructive	true	true
API-retrieve-a-page Notion \| Retrieve a page Error Responses: 400: Bad request	unknown	unknown	unknown
API-retrieve-a-page-property Notion \| Retrieve a page property item Error Responses: 400: Bad request	unknown	unknown	unknown
API-list-data-source-templates Notion \| List templates in a data source Error Responses: 400: Bad request	read	false	unknown
API-update-a-data-source Notion \| Update a data source Error Responses: 400: Bad request	write	true	unknown
API-retrieve-page-markdown Notion \| Retrieve a page as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 429: Rate limited.	read	false	unknown

02Install & source

npx -y @notionhq/notion-mcp-server

npx

repossh://git@github.com/makenotion/notion-mcp-server
packagehttps://www.npmjs.com/package/@notionhq/notion-mcp-server
homepagehttps://github.com/makenotion/notion-mcp-server#readme
licenseMIT
adoption4594 stars · 624 forks

03Access granted

Manage docs & notes · destructiveManage docs & notes · write

The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.

05Provenance & freshness

sourcesnpm registry [p4] · Awesome MCP Servers (wong2) [p6]

last_checked2026-08-16 20:30Z

next_check2026-08-16 23:30Z

cadenceevery 3h

verifiedhandshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed tools_list:passed handshake:passed

index_statusindex — 9 unique facts >= 5

06Badge

Add the “as seen on MCPExplorer” badge to your README.

[![@notionhq/notion-mcp-server MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/notionhq-notion-mcp-server.svg)](https://mcpexplorer.com/servers/notionhq-notion-mcp-server)

Next step

This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.

Explore loadouts →