Notion MCP Integration
About
Notion MCP Integration is a lightweight Model Context Protocol (MCP) server that seamlessly integrates with Notion's API to manage a minimalist personal to-do list through Claude. This project provides basic functionality tailored specifically for a simple Notion database structu
Details
- Author
- Ruijian-Zha
- GitHub stars
- 9
- Downloads
- 418
- Categories
- Knowledge Base, Project Management
Jump to
- Add new todo items with descriptions and links
- View all existing todos
- Mark tasks as complete
- Link external resources to tasks
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 IntegrationCommand (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, set up a Python virtual environment (Python 3.10+), and install with uv pip install -e .. Create a Notion integration, obtain an API key, and share your database with that integration. Configure a .env file with NOTION_API_KEY and NOTION_DATABASE_ID. Then either run the server directly with python -m notion_mcp or configure it in Claude Desktop’s claude_desktop_config.json to start automatically.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"notion mcp integration": {
"Notion_MCP_advanced": {
"command": "python",
"args": [
"-m",
"venv",
".venv"
]
}
}
}
}McpServers
{
"Notion_MCP_advanced": {
"command": "python",
"args": [
"-m",
"venv",
".venv"
]
}
}Notion MCP Integration
A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude. This is a basic implementation tailored specifically for my minimalist todo list setup in Notion.
> This project is based on danhilse/notion_mcp, which is available under the MIT license.
<p align="center">
</p>
Important Note
This is a personal project designed for a very specific use case: my simple Notion todo list that has just four properties:
- Task (title)
- Checkbox (marks if completed)
- Description (additional details)
- Link (URL or reference)
While you can use this as a starting point for your own Notion integration, you'll likely need to modify the code to match your specific database structure and requirements.
Features
- Add new todo items with descriptions and links
- View all todos
- Check off tasks as complete
- Link external resources to tasks
Prerequisites
- Python 3.10 or higher
- A Notion account
- A Notion integration (API key)
- A Notion database that matches the exact structure described above (or willingness to modify the code for your structure)
Setup
1. Clone the repository:
git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
2. Set up Python environment:
python -m venv .venv
source .venv/bin/activate # On Windows use: .venv\Scripts\activate
uv pip install -e .
3. Create a Notion integration:
- Go to https://www.notion.so/my-integrations
- Create new integration
- Copy the API key
4. Share your database with the integration:
- Open your todo database in Notion
- Click "..." menu → "Add connections"
- Select your integration
5. Create a .env file:
NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here
6. Configure Claude Desktop:
{
"mcpServers": {
"notion-todo": {
"command": "/path/to/your/.venv/bin/python",
"args": ["-m", "notion_mcp"],
"cwd": "/path/to/notion-mcp"
}
}
}
Running the Server
The server can be run in two ways:
1. Directly from the command line:
```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.
