Notion MCP — Productivity skill for Claude Code

Notion MCP Integration

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.

Important Note

This is a personal project designed for a very specific use case: my simple Notion todo list that has just three properties:

• Task (title)
• When (select with only two options: "today" or "later")
• Checkbox (marks if completed)

[Example Notion Database](https://danhilse.notion.site/14e5549555a08078afb5ed5d374bb656?v=14e5549555a081f9b5a4000cdf952cb9&pvs=4)

While you can use this as a starting point for your own Notion integration, you'll likely need to modify the code to match your specific database structure and requirements.

Features

• Add new todo items
• View all todos
• View today's tasks

Prerequisites

• 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)

Setup

1. Clone the repository:

git clone https://github.com/DMontgomery40/notion-mcp.git
cd notion-mcp

1. Set up Python environment:

python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
uv pip install -e .

1. Create a Notion integration:

   • Go to https://www.notion.so/my-integrations
   • Create new integration
   • Copy the API key

2. Share your database with the integration:

   • Open your todo database in Notion
   • Click "..." menu → "Add connections"
   • Select your integration

3. Create a `.env` file:

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

1. Configure Claude Desktop:

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