Official Notion MCP Server
MCPpedia last refreshed this data
Notion MCP Server is an MCP server that official Notion MCP Server. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 92/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"notionApi": {
"env": {
"NOTION_TOKEN": "ntn_****"
},
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
We’ve introduced Notion MCP, a remote MCP server with the following improvements: > - Easy installation via standard OAuth. No need to fiddle with JSON or API tokens anymore. > - Powerful tools tailored to AI agents, including editing pages in Markdown. These tools are designed with optimized token consumption in mind. > Learn more and get started at Notion MCP documentation. > We are prioritizing, and only providing active support for, Notion MCP (remote). As a result: > - We may sunset this
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@notionhq/notion-mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @notionhq/notion-mcp-server against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in productivity
MCP server for monday.com integration.
Local-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.
Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.
MCP Server for Computer Use in Windows
MCP Security Weekly
Get CVE alerts and security updates for Notion Mcp Server and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
[!NOTE]
We’ve introduced Notion MCP, a remote MCP server with the following improvements:
- Easy installation via standard OAuth. No need to fiddle with JSON or API tokens anymore.
- Powerful tools tailored to AI agents, including editing pages in Markdown. These tools are designed with optimized token consumption in mind.
Learn more and get started at Notion MCP documentation.
We are prioritizing, and only providing active support for, Notion MCP (remote). As a result:
- We may sunset this local MCP server repository in the future.
- Issues and pull requests here are not actively monitored.
- Please do not file issues relating to the remote MCP here; instead, contact Notion support.
This project implements an MCP server for the Notion API.
Version 2.0.0 migrates to the Notion API 2025-09-03 which introduces data sources as the primary abstraction for databases.
Removed tools (3):
post-database-query - replaced by query-data-sourceupdate-a-database - replaced by update-a-data-sourcecreate-a-database - replaced by create-a-data-sourceNew tools (7):
query-data-source - Query a data source (database) with filters and sortsretrieve-a-data-source - Get metadata and schema for a data sourceupdate-a-data-source - Update data source propertiescreate-a-data-source - Create a new data sourcelist-data-source-templates - List available templates in a data sourcemove-page - Move a page to a different parent locationretrieve-a-database - Get database metadata including its data source IDsParameter changes:
data_source_id instead of database_id["page", "database"] to ["page", "data_source"]page_id and database_id parents (for data sources)No code changes required. MCP tools are discovered automatically when the server starts. When you upgrade to v2.0.0, AI clients will automatically see the new tool names and parameters. The old database tools are no longer available.
If you have hardcoded tool names or prompts that reference the old database tools, update them to use the new data source tools:
| Old Tool (v1.x) | New Tool (v2.0) | Parameter Change |
|---|---|---|
post-database-query | query-data-source | database_id → data_source_id |
update-a-database | update-a-data-source | database_id → data_source_id |
create-a-database | create-a-data-source | No change (uses parent.page_id) |
Note:
retrieve-a-databaseis still available and returns database metadata including the list of data source IDs. Useretrieve-a-data-sourceto get the schema and properties of a specific data source.
Total tools now: 22 (was 19 in v1.x)
The server exposes two tools for working with page content as enhanced Markdown instead of block JSON, which is significantly more token-efficient for AI agents:
retrieve-page-markdown — Read a page's full content as Markdown (GET /v1/pages/{page_id}/markdown). Pass include_transcript: true to inline meeting-note transcripts.update-page-markdown — Edit a page's content with Markdown (PATCH /v1/pages/{page_id}/markdown). Prefer replace_content to overwrite the whole page, or update_content for targeted find-and-replace edits.These endpoints require Notion API version 2026-03-11. The server now sources the Notion-Version he