notion-mcp

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.

Demo

Related MCP server: Notion MCP Server

Visual Guide

Notion MCP Query 1

Notion MCP Query 2

Notion MCP Query 3

Prerequisites

• Python 3.11 or higher

• A Notion account with API access

• A Notion integration token

• A Notion page where you want to manage your todo list

• Claude Desktop clint

Setup

Installing via Smithery

To install Notion MCP for Claude Desktop automatically via Smithery:

1. Clone the repository:

2. Set up Python environment:

3. Create a Notion integration:

   • Go to https://www.notion.so/my-integrations

   • Create new integration

   • Copy the API key

4. Share your database/page with the integration:

   • Open your notion workspace with a database/table present or a page.

   • Click "..." menu → "Add connections"

   • Select your integration (Search by name)

Configuration

1. Create .env file:

2. Configure Notion credentials in .env:

3. To use it with Claude Desktop as intended you need to adjust your claude_desktop_config.json file. Go to Claude Desktop -> Settings -> Developer -> Edit Config. Now add the Notion server configuration.

Development

Project structure:

Support Functions

Show Tasks

To show all tasks from your Notion workspace, use the show_all_todos function:

Add Task

To add a new task to your Notion workspace, use the add_todo function:

Update Task

To update an existing task in your Notion workspace, use the complete_todo function:

Contributing

1. Fork the repository

2. Create feature branch

3. Submit pull request

License

MIT License. See LICENSE file for details.