mcps / notion

MCPExplorer Verified

Notion MCP server

Your team knowledge layer for agents.

Docsby Notiondestructive capableAPI keyFree · Plus from $10/user/mo →

01What it is

Notion's official MCP server lets your agent search, read, and write Notion pages and databases — so the team's knowledge base is both context and canvas.

Who it’s for: Teams who run their knowledge base in Notion and want an agent that reads and maintains it.

02Highlights

Search & read

Pull answers from pages and databases to ground the agent in your team's docs.

Write back

Create and update pages and database rows — meeting notes, specs, trackers.

03Add it to your agent

Local MCP server — runs on your machine via the command below.

claude mcp add notion -- npx -y @notionhq/notion-mcp-server

{ "mcpServers": { "notion": { "command": "npx", "args": ["-y","@notionhq/notion-mcp-server"] } } }

05What it can do · 24 tools

The real tool surface, each labeled by risk. Full trust breakdown on the server page · safety review: Is Notion MCP safe?.

Tool	Risk
API-post-search Notion \| Search by title Error Responses: 400: Bad request	write
API-retrieve-a-data-source Notion \| Retrieve a data source Error Responses: 400: Bad request	unknown
API-create-a-data-source Notion \| Create a data source Error Responses: 400: Bad request	write
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
API-move-page Notion \| Move a page Error Responses: 400: Bad request	write
API-list-data-source-templates Notion \| List templates in a data source Error Responses: 400: Bad request	read
API-patch-page Notion \| Update page properties Error Responses: 400: Bad request	write
API-retrieve-a-block Notion \| Retrieve a block Error Responses: 400: Bad request	unknown
API-retrieve-a-page-property Notion \| Retrieve a page property item Error Responses: 400: Bad request	unknown
API-retrieve-a-database Notion \| Retrieve a database Error Responses: 400: Bad request	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
API-get-user Notion \| Retrieve a user Error Responses: 400: 400	read
API-get-users Notion \| List all users Error Responses: 400: 400	read
API-get-self Notion \| Retrieve your token's bot user Error Responses: 400: Bad request	read
API-get-block-children Notion \| Retrieve block children Error Responses: 400: Bad request	read
API-patch-block-children Notion \| Append block children Error Responses: 400: Bad request	write
API-update-a-block Notion \| Update a block Error Responses: 400: Bad request	write
API-delete-a-block Notion \| Delete a block Error Responses: 400: Bad request	destructive
API-retrieve-a-page Notion \| Retrieve a page Error Responses: 400: Bad request	unknown
API-retrieve-a-comment Notion \| Retrieve comments Error Responses: 400: Bad request	write
API-create-a-comment Notion \| Create comment Error Responses: 400: Bad request	write
API-query-data-source Notion \| Query a data source Error Responses: 400: Bad request	read
API-update-a-data-source Notion \| Update a data source Error Responses: 400: Bad request	write
API-post-page Notion \| Create a page Error Responses: 400: Bad request	write

06Access

The write/destructive access this server can exercise, from its verified tools.

Manage docs & notes · destructiveManage docs & notes · write

07FAQ

What is Notion MCP?

Notion's official MCP server lets your agent search, read, and write Notion pages and databases — so the team's knowledge base is both context and canvas.

Who is Notion for?

Teams who run their knowledge base in Notion and want an agent that reads and maintains it.

What tools does Notion expose?

Notion exposes 24 verified tools, including API-post-search, API-retrieve-a-data-source, API-create-a-data-source, API-update-page-markdown, API-move-page, API-list-data-source-templates. Each is labeled by read / write / destructive risk on this page.

How do I connect Notion to my agent?

Notion runs locally over stdio. Add it to your MCP client config: claude mcp add notion -- npx -y @notionhq/notion-mcp-server.

Does Notion require authentication?

Yes — Notion authenticates with API key. You connect your own account, and it acts only within the scopes you grant.

How much does Notion cost?

Free · Plus from $10/user/mo. Free plan — the MCP works with any Notion account via an integration token. See the full pricing breakdown on the Notion pricing page.

Is Notion verified on MCPExplorer?

Yes — Notion is hand-checked and featured on MCPExplorer. We pull its real tool surface, required scopes, and risk labels from the live index so you can see exactly what it does before connecting.

08Similar MCPs

Other MCP servers worth a look in Docs.

Context7

Docs

Up-to-date library docs, on demand.

DeepWiki

Docs

Ask questions about any public GitHub repo.

ChatSEO

SEO & content

An AI SEO agent inside your MCP client.

Apex

LinkedIn & outbound

Governed LinkedIn hands for your AI agent.

09Badge

Notion is featured on MCPExplorer. Add this badge to Notion’s site or README — it links back to this page.

HTML — for your website

<a href="https://mcpexplorer.com/mcps/notion" target="_blank" rel="noopener"><img src="https://mcpexplorer.com/badge/notion.svg" alt="Notion MCP — as seen on mcpexplorer.com" height="20" /></a>

Markdown — for a README

[![Notion MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/notion.svg)](https://mcpexplorer.com/mcps/notion)

Get started

Set up Notion and put it to work — Free · Plus from $10/user/mo. Or see its full verified profile.

Visit Notion →Full profile Is it safe?