Badhansen/notion-mcp
Free与 Notion API 集成以高效管理个人待办事项列表的 MCP 服务器。
FreeFree tier
About Badhansen/notion-mcp
A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage personal todo lists. It allows AI assistants like Claude to interact with Notion tasks via three main functions: show all tasks, add a new task, and complete an existing task. The server requires Python 3.11+ and can be installed via Smithery or manually cloned from GitHub. Configuration involves setting up Notion API credentials and adding the server to Claude Desktop's configuration. Licensed under MIT.
Key Features
Integrates with Notion's API to manage personal todo lists
Supports three core operations: show_all_todos, add_todo, complete_todo
Compatible with Claude Desktop and other MCP clients
Installation via Smithery or manual clone and setup
Uses Python 3.11+ and uv for environment management
Open source under MIT license
Pros & Cons
Pros
- Free and open source
- Simple setup with clear documentation and prerequisites
- Integrates directly with widely used Notion platform
- Covers essential task operations: list, add, complete
Cons
- Designed for personal todo lists, limited scalability for teams
- Requires manual Notion integration setup (API token and page sharing)
- Only supports three functions (no update description, delete, etc.)
Best For
Personal task management using Notion databasesIntegrating Notion todo lists with AI assistants like ClaudeAutomating task tracking and updates via MCP protocol
FAQ
What is Notion MCP?
It's a Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing AI assistants like Claude to interact with Notion tasks.
What are the prerequisites?
Python 3.11 or higher, a Notion account with API access, a Notion integration token, a Notion page for the todo list, and Claude Desktop.
How do I install Notion MCP?
You can install via Smithery using `npx -y @smithery/cli install @Badhansen/notion-mcp --client claude` or manually clone the repository and set up a Python environment with uv.
How do I configure it for Claude Desktop?
Add the server configuration to your claude_desktop_config.json with the command and path to the `server.py` file as shown in the README.
What functions does it support?
It supports show_all_todos (list all tasks), add_todo (add a new task), and complete_todo (mark a task as complete by task ID).