Happy slice of mcp pizzaMCP.pizza

notion_mcp

MCP.Pizza Chef: danhilse

Built by one person for their own minimalist Notion board, this small add-on gives an assistant four abilities: list every task, list only today's tasks, add a task marked today or later, and mark a task done. It cannot rename tasks, delete rows, or handle tags, dates, or priorities. Your Notion database has to use exactly three fields named Task, When, and Checkbox, and you supply a Notion integration token. The code has not changed since December 2024.

Unmaintained · no changes since December 2024; personal one-board project
Notes

Use This MCP server To

Add a task to my Notion list without switching apps See everything on my to-do list at once Check what I planned for today Mark a finished task as complete Capture a to-do in the middle of a conversation

README

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

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
  • Check off a task as complete

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/yourusername/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:

  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

notion_mcp FAQ

Is this project still being updated?
No. The code has not changed since December 2024, and the author calls it a personal project built for one specific to-do board.
Do I need a Notion key?
Yes. You create a free Notion integration, copy its token, and share your to-do database with it.
Will it work with my existing Notion to-do list?
Only if that list has exactly three fields named Task, When, and Checkbox. Anything else means editing the code yourself.
Can I use this to delete or rename a task?
No. It can only add tasks and tick them off, so removals and edits still happen inside Notion.
Can I use this to plan my week?
Only loosely. Every task is either today or later, with no real dates, priorities, or repeats.
Which apps does it work in?
The instructions cover Claude Desktop, and any assistant that can launch a small local program will work with equivalent settings.
How hard is setup?
Fairly involved. You download the code, install Python 3.10 or newer, create the Notion connection, and edit a settings file by hand.