Badhansen/notion-mcp

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.
Demo
Visual Guide
Notion MCP Query 1
Notion MCP Query 2
Notion MCP Query 3
Prerequisites
- Python 3.11 or higher
- A Notion account with API access
- A Notion integration token
- A Notion page where you want to manage your todo list
- Claude Desktop clint
Setup
Installing via Smithery
To install Notion MCP for Claude Desktop automatically via Smithery:
1. Clone the repository:
2. Set up Python environment:
3. Create a Notion integration:
- Go to https://www.notion.so/my-integrations
- Create new integration
- Copy the API key
4. Share your database/page with the integration:
- Open your notion workspace with a database/table present or a page.
- Click "..." menu → "Add connections"
- Select your integration (Search by name)
Configuration
1. Create .env file:
2. Configure Notion credentials in .env:
3. To use it with Claude Desktop as intended you need to adjust your claude_desktop_config.json file.
Go to Claude Desktop -> Settings -> Developer -> Edit Config. Now add the Notion server configuration.
Development
Project structure:
Support Functions
Show Tasks
To show all tasks from your Notion workspace, use the show_all_todos function:
Add Task
To add a new task to your Notion workspace, use the add_todo function:
Update Task
To update an existing task in your Notion workspace, use the complete_todo function:
Contributing
1. Fork the repository
2. Create feature branch
3. Submit pull request
License
MIT License. See LICENSE file for details.