Advertise
MCP.so
Sign In

Notion MCP Integration

@Ruijian-Zha

Repository

Basic information

Category

Memory & Knowledge

License

MIT

Transports

stdio

Author

Ruijian-Zha

About Notion MCP Integration

Notion MCP Integration is a lightweight Model Context Protocol (MCP) server that seamlessly integrates with Notion's API to manage a minimalist personal to-do list through Claude. This project provides basic functionality tailored specifically for a simple Notion database structu

#notion#task-management#mcp-integration

Notion MCP Integration config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Notion_MCP_advanced": {
      "command": "python",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Notion MCP Integration tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Notion MCP Integration?

Notion MCP Integration is a simple Model Context Protocol (MCP) server that integrates with Notion’s API to manage a personal todo list through Claude. It is tailored for a minimalist Notion database structure with exactly four properties: Task (title), Checkbox, Description, and Link. It is based on the open-source project danhilse/notion_mcp.

How to use Notion MCP Integration?

Clone the repository, set up a Python virtual environment (Python 3.10+), and install with uv pip install -e .. Create a Notion integration, obtain an API key, and share your database with that integration. Configure a .env file with NOTION_API_KEY and NOTION_DATABASE_ID. Then either run the server directly with python -m notion_mcp or configure it in Claude Desktop’s claude_desktop_config.json to start automatically.

Key features of Notion MCP Integration

  • Add new todo items with descriptions and links
  • View all existing todos
  • Mark tasks as complete
  • Link external resources to tasks

Use cases of Notion MCP Integration

  • Managing a personal minimalist todo list via Claude
  • Quickly adding tasks with notes and URLs from conversation
  • Checking off completed items without opening Notion
  • Reviewing all pending tasks through a chat interface

Frequently asked questions

1

What database structure does this server require?

It requires a Notion database with exactly four properties: Task (title), Checkbox, Description, and Link. The code is tailored specifically for this schema.

2

Can I use this server with a different Notion database structure?

The README states that you will likely need to modify the code to match your own database structure and requirements. No support for complex or custom schemas is included.

3

What are the prerequisites?

Python 3.10 or higher, a Notion account, a Notion integration (API key), and a Notion database that matches the described structure (or willingness to modify the code).

4

How do I run the server?

You can run it directly from the command line with `python -m notion_mcp` (no output unless errors) or configure it in Claude Desktop to start automatically when Claude launches and stop when Claude is closed.

5

Are there any known limitations?

Yes: the server only works with a specific Notion database structure, has basic error handling, and does not support complex schemas, additional properties, recurring tasks, priorities, or tags.

Comments

More Memory & Knowledge MCP servers

Sensefold

SenseFold Labs

Personal context for every AI: search, read, and write back to your private Markdown library of articles, threads, PDFs, notes, and captured ChatGPT/Claude/Gemini/Grok conversations. Remote server, OAuth 2.1 paste-and-au

Sooveryn

PANDAPROG

Sooveryn gives Claude Code a team of AI personas that remembers your project. Soov, the partner and team lead, keeps your decisions and how you work in a lasting memory, and finds them again by words and by meaning, from

AOCI-CODE

aoci-spec

Local MCP server and CLI that keeps a Git-versioned, model-written index of a codebase and its database schema, so coding agents start each task with the whole system in view.

1.7K

Tempreon

Tempreon

Person-owned, portable AI memory served over MCP. Your knowledge, preferences, and decisions — captured in one assistant, available in all of them.

server-noonien - shared memory MCP

sequico

Shared, serverless, conflict-free memory for AI agents: a multi-machine drop-in for the MCP memory knowledge graph.

Advertise