Notion MCP Server
@mikeysrecipes
About Notion MCP Server
No overview available yet
Basic information
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
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
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.
More Memory & Knowledge MCP servers
Notion MCP Server
makenotionOfficial Notion MCP Server
JupyterMCP - Jupyter Notebook Model Context Protocol Integration
jjsantos01A Model Context Protocol (MCP) for Jupyter Notebook
Zettelkasten MCP Server
entanglrA Model Context Protocol (MCP) server that implements the Zettelkasten knowledge management methodology, allowing you to create, link, explore and synthesize atomic notes through Claude and other MCP-compatible clients.
MemoryMesh
CheMiguel23A knowledge graph server that uses the Model Context Protocol (MCP) to provide structured memory persistence for AI models.
mcp-local-rag
nkapila6"primitive" RAG-like web search model context protocol (MCP) server that runs locally. ✨ no APIs ✨
Comments