Notion MCP Server
About
MCP server for the Notion API, enabling real-time interactions via Server-Sent Events (SSE).
Details
- Author
- contexaai
- Downloads
- 375
- Categories
- Productivity, Other, Knowledge Base, Automation
- Tags
- #notion, #document
Jump to
- MCP server for the Notion API
- Supports searching, reading, commenting, and creating pages
- Uses Server-Sent Events (SSE) transport (fork modification)
- Installable via npm or Docker
- Read-only token option for security-conscious users
- Designed for use with AI assistants like Claude
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Notion MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install and configure the server by setting up an internal Notion Integration, copying the integration token, and adding the MCP configuration to your client (e.g., .cursor/mcp.json or claude_desktop_config.json). You can run it via npx or Docker, providing the token and Notion version in the OPENAPI_MCP_HEADERS environment variable. Then instruct your AI to perform actions like commenting or creating pages.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"notion mcp server": {
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OPENAPI_MCP_HEADERS",
"mcp/notion"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
}
}
}McpServers
{
"notionApi": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"OPENAPI_MCP_HEADERS",
"mcp/notion"
],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
}
}
}MCP server for the Notion API, enabling real-time interactions via Server-Sent Events (SSE).
Deploy and get started in minutes on ContexaAI
This repository is a fork of the official Notion MCP server available on NPM. The primary modification is the replacement of the transport mechanism from Stdio to Server-Sent Events (SSE).
This project implements anMCP serverfor theNotion API.
While we limit the scope of Notion API's exposed (for example, you will not be able to delete databases via MCP), there is a non-zero risk to workspace data by exposing it to LLMs. Security-conscious users may want to further configure the Integration'sCapabilities.
For example, you can create a read-only integration token by giving only "Read content" access from the "Configuration" tab:
Ensure relevant pages and databases are connected to your integration.
To do this, you'll need to visit that page, and click on the 3 dots, and select "Connect to integration".
Add the following to your.cursor/mcp.jsonorclaude_desktop_config.json(MacOS:~/Library/Application\ Support/Claude/claude_desktop_config.json)
{ "mcpServers": { "notionApi": { "command": "npx", "args": ["-y", "@notionhq/notion-mcp-server"], "env": { "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_*\", \"Notion-Version\": \"2022-06-28\" }" } } } }
There are two options for running the MCP server with Docker:
Add the following to your.cursor/mcp.jsonorclaude_desktop_config.json:
{ "mcpServers": { "notionApi": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "OPENAPI_MCP_HEADERS", "mcp/notion" ], "env": { "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_\",\"Notion-Version\":\"2022-06-28\"}" } } } }
- Uses the official Docker Hub image
- Properly handles JSON escaping via environment variables
- Provides a more reliable configuration method
You can also build and run the Docker image locally. First, build the Docker image:
Then, add the following to your.cursor/mcp.jsonorclaude_desktop_config.json:
{ "mcpServers": { "notionApi": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_\", \"Notion-Version\": \"2022-06-28\"}", "notion-mcp-server" ] } } }
Don't forget to replacentn_*with your integration secret. Find it from your integration configuration tab:
Comment "Hello MCP" on page "Getting started"
AI will correctly plan two API calls,v1/searchandv1/comments, to achieve the task
- Similarly, the following instruction will result in a new page named "Notion MCP" added to parent page "Development"
Add a page titled "Notion MCP" to page "Development"
- You may also reference content ID directly
Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2
npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server
Official Notion MCP server for searching, reading, creating, and updating Notion pages, databases, and workspace content from AI agents.
Markdown-first Notion MCP server with 9 composite tools, 39 actions, and ~77% token reduction via tiered docs.
An MCP server for the Notion API, allowing language models to interact with Notion workspaces.
Connects AI assistants to your Notion workspace to search and manage pages, databases, and content.
Connects AI assistants to your Notion workspace, allowing you to search, create, and manage content using natural language.
Search, read, create, and update pages and databases in your Notion workspace.
Integrate with Notion workspaces to manage databases, pages, and content.
An MCP server for interacting with your Notion workspace, enabling LLMs to manage pages and databases.
An optimized, read-only MCP server for the Notion API with asynchronous processing.
MCP server for Paperless-ngx document management. 43 tools for AI-powered document organization - full CRUD on documents, tags, correspondents, document types, storage paths, and custom fields.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
