notion-mcp
notion-mcp is an MCP server, listed under project & docs. It reaches notion. It needs NOTION_TOKEN to authenticate. Its repository has 31 GitHub stars and is licensed under MIT; we last read it on 2026-10-22.
This software acts as a Model Context Protocol (MCP) server, connecting to Notion's API to manage a personal todo list.
Install
MCP servers are packaged differently from each other -- some run via npx, some as a Docker image, some as a plain script you clone and run. notion-mcp’s own README did not state one plainly enough for this page to quote it rather than guess, so it will not guess. The repository below states it.
What it reaches, and what it needs
Maintenance
A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.
What notion-mcp can do
3 tools documented in its README. An AI client calls these by name.
show_all_todos- No description in the README.
add_todo- No description in the README.
complete_todo- No description in the README.
Read from the README; names are kept only if the README contains them.
notion-mcp compared with similar servers
| Server | Reaches | Needs | Stars | Last update | Licence |
|---|---|---|---|---|---|
| notion-mcp (this page) | notion | NOTION_TOKEN | 31 | 2025-09-30 | MIT |
| mcp-notion-server | notion(1 shared) | NOTION_API_TOKEN | 924 | 2026-07-31 | MIT |
| notion_mcp | notion(1 shared) | NOTION_API_KEY | 208 | 2024-12-18 | MIT |
| notion-mcp-server | notion(1 shared) | MCP_AUTH_TOKEN, NOTION_TOKEN | 178 | 2026-10-21 | MIT |
| notion-api-mcp | notion(1 shared) | NOTION_API_KEY | 28 | 2025-01-14 | MIT |
| tablecharts-mcp-server | googlesheets, notion, salesforce, tablecharts(1 shared) | TABLECHARTS_API_KEY | 0 | 2026-07-04 | MIT |
Ranked by services in common with notion-mcp, then by stars. Figures are from each repository when we last read it.
Common questions about notion-mcp
- What does notion-mcp do?
- This software acts as a Model Context Protocol (MCP) server, connecting to Notion's API to manage a personal todo list.
- How do I install notion-mcp?
- Its README did not state an install command plainly enough for us to quote one, so we do not guess. The repository has the instructions: https://github.com/Badhansen/notion-mcp
- What does notion-mcp connect to, and what does it need?
- It reaches notion. The credentials we found in its source are NOTION_TOKEN.
- Is notion-mcp official and is it maintained?
- We found nothing naming it as a vendor’s official server. Its repository has 31 GitHub stars and its state in our directory is stale. Its last commit we recorded was on 2025-09-30.
- What licence does notion-mcp use?
- The repository declares the MIT licence.
More MCP servers for project & docs
- mcp-obsidian4,486 stars
- mcp-notion-server924 stars
- obsidian-mcp-server699 stars
- todoist-mcp562 stars
- linear-mcp-server347 stars
- notion_mcp208 stars