Notion MCP Server
About
Notion MCP Server implements the Model Context Protocol to interface with Notion’s API, enabling AI models to read and write Notion documents and data. It is built with the official MCP Python SDK and is intended for use with MCP‑compatible LLM clients like Claude for Desktop.
Details
- Author
- flyer103
- Downloads
- 213
- Categories
- Knowledge Base
Jump to
- Supports 14 tools for pages, databases, blocks, comments, and search.
- Two transport methods: stdio (default) and SSE.
- Configured via a single environment variable (NOTION_API_KEY).
- Requires Python 3.12+ and the uv package manager.
- Seamlessly integrates with Claude for Desktop through a JSON config file.
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
Clone the repository, create a virtual environment, and install dependencies with uv. Obtain a Notion API key from the Notion integrations page and set it as the NOTION_API_KEY environment variable. Run python -m notion_mcp.server (stdio) or use --transport sse for SSE. For Claude for Desktop, add a claude_desktop_config.json file pointing to the uv executable and the server directory.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"notion mcp server": {
"notion-mcp-flyer103": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}
McpServers
{
"notion-mcp-flyer103": {
"command": "uv",
"args": [
"venv"
]
}
}
Notion MCP Server
A Model Context Protocol (MCP) server for interacting with Notion APIs.
Overview
This project implements an MCP server that interfaces with Notion's API, allowing AI models to interact with Notion documents and data. It follows the Model Context Protocol specification and uses the official MCP Python SDK.
Requirements
- Python 3.12 or higher
- uv for package management
Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


