notion-mcp
@Badhansen
About notion-mcp
A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"notion-mcp-badhansen": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@Badhansen/notion-mcp",
"--client",
"claude"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is notion-mcp?
A Model Context Protocol (MCP) server that integrates with Notion's API to manage a personal todo list, designed for use with the Claude Desktop client.
How to use notion-mcp?
Install via Smithery with npx -y @smithery/cli install @Badhansen/notion-mcp --client claude, or clone the repository, set up a Python virtual environment, configure Notion credentials in a .env file, and add the server configuration to claude_desktop_config.json. Then invoke functions like show_all_todos, add_todo, or complete_todo through Claude.
Key features of notion-mcp?
- Integrates with Notion API for task management
- Supports showing all todos
- Supports adding new todos
- Supports completing existing todos
- Designed for Claude Desktop client
- Simple installation via Smithery or manual clone
Use cases of notion-mcp?
- Manage a personal todo list in Notion via Claude
- Retrieve all tasks with a single command
- Add tasks using natural language
- Mark tasks as complete without leaving Claude
FAQ from notion-mcp
What does notion-mcp do?
It is an MCP server that lets Claude Desktop interact with your Notion workspace to manage a todo list.
What prerequisites are required?
Python 3.11 or higher, a Notion account with API access, a Notion integration token, a Notion page for the todo list, and the Claude Desktop client.
How is notion-mcp installed?
It can be installed automatically via Smithery or by cloning the repository, creating a Python virtual environment with uv, and configuring a .env file.
How are Notion credentials configured?
Set NOTION_TOKEN, PAGE_ID, `NOTION
Frequently asked questions
What does notion-mcp do?
It is an MCP server that lets Claude Desktop interact with your Notion workspace to manage a todo list.
What prerequisites are required?
Python 3.11 or higher, a Notion account with API access, a Notion integration token, a Notion page for the todo list, and the Claude Desktop client.
How is notion-mcp installed?
It can be installed automatically via Smithery or by cloning the repository, creating a Python virtual environment with `uv`, and configuring a `.env` file.
How are Notion credentials configured?
Set `NOTION_TOKEN`, `PAGE_ID`, `NOTION
Basic information
More Memory & Knowledge MCP servers
Anytype MCP Server
anyprotoAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.
Tempreon
TempreonPerson-owned, portable AI memory served over MCP. Your knowledge, preferences, and decisions — captured in one assistant, available in all of them.

PLUR
plur-aiAI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference
Notion MCP Server
suekouA Model Context Protocol server for connecting Notion to MCP-compatible clients
Obsidian MCP Server
cyanheadsRead, write, search, and surgically edit Obsidian vault notes, tags, and frontmatter via MCP. STDIO or Streamable HTTP.
Comments