mcp-registry/notion_mcp

    ==================
      
       /// MCP ///
      /// NOT ///
        
    ==================
        
    [server:online]
    [protocol:ready]

notion_mcp

by danhilse

A simple Model Context Protocol (MCP) server that lets Claude read and manage a minimalist Notion todo list.

190
46
Specialized
GitHubWebsiteDocumentation

01

Add new todo items

Create and add a new task to the Notion todo database.

02

View all todos

Retrieve and display every task stored in the Notion todo database.

03

View today's tasks

Retrieve and display only the tasks scheduled for "today" in the Notion todo database.

04

Check off a task as complete

Mark a specified task's checkbox property as completed in the Notion todo database.

Installation

1. Clone the repository
git clone https://github.com/danhilse/notion_mcp.git && cd notion_mcp
2. Create and activate a Python virtual environment (recommended)
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
3. Install dependencies
pip install -r requirements.txt
4. Configure environment variables (add them to ~/.bash_profile, .env, or your hosting dashboard)
export NOTION_API_KEY="<your_integration_secret>"
export NOTION_DATABASE_ID="<todo_database_id>"
# Optional MCP config
export MCP_PORT=8000
export MCP_AUTH_TOKEN="<shared_secret_if_required>"
5. Run the MCP server locally
python main.py # or whatever the entry file is, often app.py / server.py
# The service will start on http://localhost:8000 (override with MCP_PORT)
6. Deploy (optional)
• Docker: docker build -t notion_mcp . && docker run -e NOTION_API_KEY=... -e NOTION_DATABASE_ID=... -p 80:8000 notion_mcp
• Render/Fly/Heroku: point to the repo, add the same env-vars, set the start command to "python main.py"

Documentation

# Transform Your Coding Workflow with Notion Todo Management in Augment Code

Stop context-switching between your code editor and Notion to manage your development tasks. This MCP server brings your Notion todo list directly into Augment Code, letting you seamlessly manage tasks through natural conversation while you code.

## Seamless Task Management While You Code

With this MCP server connected to Augment Code, you can manage your entire development workflow without leaving your coding environment. Ask Augment to "show me what's on my plate for today" and instantly see your prioritized tasks, or say "add a task to refactor the authentication module" and watch it appear in your Notion database. This integration transforms how you handle project management during development sessions—no more losing focus by switching between apps or forgetting to track completed work.

## Boost Your Development Productivity

The real power emerges when Augment Code can contextually manage your tasks based on your current coding work. As you're debugging a complex issue, tell Augment "add a task to investigate the memory leak in the user service" and it's immediately captured with proper context. When you complete a feature, simply say "mark the payment integration task as done" and Augment handles the Notion update. This creates a natural flow where task management becomes part of your coding rhythm, not a separate administrative burden.

Perfect for developers who use Notion for project planning and want their AI coding assistant to understand and interact with their actual task pipeline. Whether you're working on personal projects or managing team deliverables, this integration keeps your development tasks synchronized with your actual coding progress, creating a more organized and efficient development workflow.
License: MIT License
Updated 7/15/2025

Table of Contents