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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
Related Resources
Related MCP Servers
- -securityAlicense-qualityA simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude.Last updated -117PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.Last updated -95PythonMIT License
- -securityAlicense-qualityA Model Context Profile server that enables Claude to interact with Todoist, allowing users to create, retrieve, update, and manage tasks through natural language commands.Last updated -1PythonMIT License
- -securityAlicense-qualityA Model Context Protocol server that bridges Claude with Google Tasks, allowing users to manage task lists and tasks directly through Claude interface.Last updated -5TypeScriptMIT License