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
- License
- Apache-2.0 license
Explore
- 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
- Python 3.12 or higher
- uv for package management
uv venv
source .venv/bin/activate
uv pip install -e ".[dev]"
```
To verify that Claude is correctly configured to use your Notion MCP server, you can ask Claude:
"Can you list the tools you have access to?" or "Can you create a new page in my Notion workspace?"
If there are any connection issues, check that:
- The configuration file is correctly formatted and in the right location
- The paths in the configuration are correct
- Your Notion integration has the proper permissions
The Notion MCP server provides the following capabilities as tools:
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"
]
}
}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.
