Notion MCP Server
@mikeysrecipes
About Notion MCP Server
No overview available yet
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?
Notion MCP Server is a Model Context Protocol server that connects AI assistants to the Notion API, enabling LLMs to interact with Notion pages and databases through natural language instructions. It is designed for developers using MCP-compatible clients such as Claude Desktop or Cursor.
How to use Notion MCP Server?
Set up a Notion internal integration to obtain a bearer token, then configure the server in your client's mcp.json or claude_desktop_config.json using either npx or Docker. Ensure relevant pages and databases are connected to your integration via the Notion UI before making requests.
Key features of Notion MCP Server
- Searches, reads, and comments on Notion pages
- Creates new pages under specified parent pages
- Retrieves content by page or database ID
- Uses HTTP Bearer token for authentication
- Cannot delete databases via MCP
Use cases of Notion MCP Server
- Add a comment to a specific Notion page
- Create a new page under a given parent page
- Search for pages by name and retrieve their content
- Fetch the content of a page using its direct ID
FAQ from Notion MCP Server
What permissions does the Notion integration need?
The integration can be configured with read-only access by checking only "Read content" in the Notion Integration's Capabilities tab. Security-conscious users may want to restrict permissions to limit risk to workspace data.
What are the runtime requirements?
The server runs via Node.js (using npx) or Docker. For npx, Node.js must be installed. Docker users can pull the official image mcp/notion or build locally with docker-compose build.
Where does my data live?
All data stays within your Notion workspace. The MCP server acts as a bridge between your AI client and the Notion API, but does not store or cache page content externally.
What are the known limitations?
The server intentionally limits the scope of the Notion API — for example, you cannot delete databases via MCP. There is a non-zero risk to workspace data when exposing it to LLMs, so read-only token usage is recommended for security.
How do I configure the transport and authentication?
The server uses the OPENAPI_MCP_HEADERS environment variable to pass an HTTP Authorization header with your Notion bearer token and the required Notion-Version header (set to 2022-06-28). No other transport methods are supported.
Frequently asked questions
What permissions does the Notion integration need?
The integration can be configured with read-only access by checking only "Read content" in the Notion Integration's Capabilities tab. Security-conscious users may want to restrict permissions to limit risk to workspace data.
What are the runtime requirements?
The server runs via Node.js (using `npx`) or Docker. For `npx`, Node.js must be installed. Docker users can pull the official image `mcp/notion` or build locally with `docker-compose build`.
Where does my data live?
All data stays within your Notion workspace. The MCP server acts as a bridge between your AI client and the Notion API, but does not store or cache page content externally.
What are the known limitations?
The server intentionally limits the scope of the Notion API — for example, you cannot delete databases via MCP. There is a non-zero risk to workspace data when exposing it to LLMs, so read-only token usage is recommended for security.
How do I configure the transport and authentication?
The server uses the `OPENAPI_MCP_HEADERS` environment variable to pass an HTTP Authorization header with your Notion bearer token and the required `Notion-Version` header (set to `2022-06-28`). No other transport methods are supported.
Basic information
More Memory & Knowledge MCP servers
Orcha
westonhancockOrcha is a unified context layer for AI tools and agents. It stores and indexes and exposes organizational, team, or individual knowledge. Files, structured databases, and connected sources live in one workspace, and age
Docs MCP Server
araboldGrounded Docs MCP Server: Open-Source Alternative to Context7, Nia, and Ref.Tools
Memlord
MyrikLDMemlord is a remote MCP server available at https://app.memlord.com.
Rust Docs MCP Server
Govcraft🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.
The Cloud
TekaThe Cloud is the AI-native workspace that gives every AI — Claude, ChatGPT, Gemini, and other Frontier & Free or Local models — shared memory and real agents. Not cloud computing: thecloud.so is one workspace where your
Comments