Notion MCP
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Integrates with Notion's API to manage personal todo lists, providing functions to show all tasks, add new tasks, and update existing tasks in a Notion workspace.
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:
- Clone the repository:
- Set up Python environment:
- Create a Notion integration:
- Go to https://www.notion.so/my-integrations
- Create new integration
- Copy the API key
- 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
- Create
.env
file:
- Configure Notion credentials in
.env
:
- To use it with Claude Desktop as intended you need to adjust your
claude_desktop_config.json
file. Go toClaude Desktop -> Settings -> Developer -> Edit Config
. Now add theNotion
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
- Fork the repository
- Create feature branch
- Submit pull request
License
MIT License. See LICENSE file for details.
This server cannot be installed
A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.