# notion_mcp

> MCP Client

This repository provides a Model Context Protocol (MCP) server that integrates with the Notion API to manage a personal todo list using Claude, tailored for a minimalist Notion database structure.

## Overview

- **Category:** Productivity
- **Language:** Python
- **Stars:** 209
- **Forks:** 31
- **Owner:** danhilse
- **GitHub:** https://github.com/danhilse/notion_mcp
- **Homepage:** https://www.danhilse.com
- **Created:** 2024-11-30T03:28:34+00:00
- **Updated:** 2025-03-28T02:16:53+00:00
- **Source:** https://model-context-protocol.com/clients/notion-todo-list-claude-mcp-integration

## Setup

## Setup

1. Clone the repository:
```bash
git clone https://github.com/yourusername/notion-mcp.git
cd notion-mcp
```

2. Set up Python environment:
```bash
python -m venv .venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate
uv pip install -e .
```

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

4. Share your database with the integration:
   - Open your todo database in Notion
   - Click "..." menu → "Add connections"
   - Select your integration

5. Create a `.env` file:
```env
NOTION_API_KEY=your-api-key-here
NOTION_DATABASE_ID=your-database-id-here
```

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

## Tools

## Available Tools

		1. Add new todo items (Allows adding new tasks to the Notion database).
		2. View all todos (Displays all tasks in the Notion database).
		3. View today's tasks (Shows tasks scheduled for today).
		4. Check off a task as complete (Marks a task as completed in the Notion database).