Notion MCP Server
@MCP-Mirror
About Notion MCP Server
Mirror of
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
}
}
}
}Tools
24Notion | Retrieve a user Error Responses: 400: 400
Notion | List all users Error Responses: 400: 400
Notion | Retrieve your token's bot user Error Responses: 400: Bad request
Notion | Search by title Error Responses: 400: Bad request
Notion | Retrieve block children Error Responses: 400: Bad request
Notion | Append block children Error Responses: 400: Bad request
Notion | Retrieve a block Error Responses: 400: Bad request
Notion | Update a block Error Responses: 400: Bad request
Notion | Delete a block Error Responses: 400: Bad request
Notion | Retrieve a page Error Responses: 400: Bad request
Notion | Update page properties Error Responses: 400: Bad request
Notion | Create a page Error Responses: 400: Bad request
Notion | Retrieve a page property item Error Responses: 400: Bad request
Notion | Retrieve comments Error Responses: 400: Bad request
Notion | Create comment Error Responses: 400: Bad request
Notion | Query a data source Error Responses: 400: Bad request
Notion | Retrieve a data source Error Responses: 400: Bad request
Notion | Update a data source Error Responses: 400: Bad request
Notion | Create a data source Error Responses: 400: Bad request
Notion | List templates in a data source Error Responses: 400: Bad request
Notion | Retrieve a database Error Responses: 400: Bad request
Notion | Move a page Error Responses: 400: Bad request
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.
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.
Overview
What is Notion MCP Server?
An MCP (Model Context Protocol) server that provides a controlled interface to the Notion API, allowing AI assistants to search, read, comment on, and create pages and databases. Designed for developers who want to let LLMs interact with Notion workspaces safely.
How to use Notion MCP Server?
Create a Notion internal integration to obtain a secret token, then add the MCP configuration to your client’s mcp.json or claude_desktop_config.json. Use either npx or Docker, providing the token via the OPENAPI_MCP_HEADERS environment variable. Connect your integration to the pages/databases you want the server to access.
Key features of Notion MCP Server
- Wraps the Notion API as an MCP server for LLMs.
- Supports searching, reading, commenting, and creating pages.
- Deliberately excludes destructive operations like deleting databases.
- Works with both npx (Node.js) and Docker.
- Allows read-only token configuration for enhanced security.
Use cases of Notion MCP Server
- Ask an AI to comment "Hello MCP" on a specific Notion page.
- Instruct the AI to create a new page titled "Notion MCP" under a parent page.
- Retrieve the content of a page by its ID.
FAQ from Notion MCP Server
What operations does Notion MCP Server support?
It can search for pages, read page content, add comments, and create new pages. Deleting databases is intentionally not supported.
Can I restrict the server to read-only access?
Yes. In the Notion integration settings you can give only "Read content" access, creating a read-only token.
What runtime dependencies are required?
You need either Node.js and npm (to run via npx) or Docker (to build and run the container).
How do I connect my Notion pages to the integration?
Visit each page, click the three dots, and select "Connect to integration" to link it to your integration token.
Where does my data reside?
All data stays in Notion's servers. The MCP server is just a proxy that makes API calls—it does not store or cache your data.
Frequently asked questions
What operations does Notion MCP Server support?
It can search for pages, read page content, add comments, and create new pages. Deleting databases is intentionally not supported.
Can I restrict the server to read-only access?
Yes. In the Notion integration settings you can give only "Read content" access, creating a read-only token.
What runtime dependencies are required?
You need either Node.js and npm (to run via `npx`) or Docker (to build and run the container).
How do I connect my Notion pages to the integration?
Visit each page, click the three dots, and select "Connect to integration" to link it to your integration token.
Where does my data reside?
All data stays in Notion's servers. The MCP server is just a proxy that makes API calls—it does not store or cache your data.
Basic information
More Memory & Knowledge MCP servers
Context7 MCP - Up-to-date Docs For Any Cursor Prompt
upstashContext7 Platform -- Up-to-date code documentation for LLMs and AI code editors
MemoryMesh
CheMiguel23A knowledge graph server that uses the Model Context Protocol (MCP) to provide structured memory persistence for AI models.
RAG Documentation MCP Server
hannesrudolphAn MCP server implementation that provides tools for retrieving and processing documentation through vector search, enabling AI assistants to augment their responses with relevant documentation context.
minutes
silversteinEvery meeting, every idea, every voice note — searchable by your AI. Open-source, privacy-first conversation memory layer.
MCP Apple Notes
RafalWilinskiTalk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.
Comments