Notion MCP Server

Integrates Claude with Notion to manage a personal todo list using natural language commands.

Local serverstdioPython★ 208

What is the Notion MCP Server?

Integrates Claude with Notion to manage a personal todo list using natural language commands.

What it actually does

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list through Claude. This is a basic implementation tailored specifically for my minimalist todo list setup in Notion.

  • Add new todo items
  • View all todos
  • View today's tasks
  • Check off a task as complete

Configuration

  • Python 3.10 or higher - A Notion account - A Notion integration (API key) - A Notion database that matches the exact structure described above (or willingness to modify the code for your structure)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Notion MCP Server

{
  "mcpServers": {
    "notion-todo": {
      "command": "/path/to/your/.venv/bin/python",
      "args": [
        "-m",
        "notion_mcp"
      ],
      "cwd": "/path/to/notion-mcp"
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.10 or higher - A Notion account - A Notion integration (API key) - A Notion database that matches the exact structure described above (or willingness to modify the code for your structure)

Frequently asked questions

The setup involves cloning the repository, setting up a Python environment, creating a Notion integration, sharing your database with the integration, and configuring Claude Desktop with the server details.