Design Engineer Logo
Visit Repo
Open Graph preview

Notion MCP

A simple MCP integration that allows Claude to read and manage a personal Notion todo list

Site favicon
💵 Business

Overview

Notion MCP

Description: A server integration that enables Claude to manage personal Notion todo lists

Category: Productivity & Task Management

Overview: This server implementation provides a bridge between Claude and Notion's API for managing a minimalist todo list. It's designed for a specific todo list structure with three properties:

  • Task (title)
  • When (select: "today" or "later")
  • Checkbox (completion status)

Key Features:

  • Add new todo items
  • View all todos
  • Filter today's tasks
  • Mark tasks as complete

Requirements:

  • Python 3.10+
  • Notion account & API key
  • Notion database with matching structure

Installation:

git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
uv pip install -e .

Configuration: Create .env file with:

NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here

MCP Server Config:

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

Usage Examples:

  • "Show all my todos"
  • "What's on my list for today?"
  • "Add a todo for today: check emails"
  • "Add a task for later: review project"

Note: This implementation is specifically designed for a minimalist todo list setup. Customization would require modifying the code to match different database structures.