drio
Open app

Notion MCP Integration

Source

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 structure, enabling efficient task management without unnecessary complexity.

Catalog onlyCatalog onlySTDIO

Overview

Notion MCP Integration is a lightweight Model Context Protocol (MCP) server that allows seamless integration with Notion's API for managing a minimalist personal to-do list using Claude. This project focuses on providing straightforward functionality for a simple Notion database structure.

To use this integration, you will clone the project repository, set up a Python environment, create a Notion integration for API access, and configure Claude Desktop to run the server that manages your tasks through voice commands.

  • Add new to-do items with basic commands - View all current and today’s tasks - Check off tasks as completed - Supports a simple task description for items - Designed for minimalist task management
  1. Managing daily tasks with voice commands through Claude.
  2. Simplifying task tracking for personal projects.
  3. Developing a custom integration with Notion for specific databases.

Add to your AI client

Use these steps to connect Notion MCP Integration in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "notion-mcp-advanced-ruijian-zha": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-advanced-ruijian-zha"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "notion-mcp-advanced-ruijian-zha": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-advanced-ruijian-zha"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "notion-mcp-advanced-ruijian-zha": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-advanced-ruijian-zha"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "notion-mcp-advanced-ruijian-zha": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-advanced-ruijian-zha"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "notion-mcp-advanced-ruijian-zha": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-advanced-ruijian-zha"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "notion-mcp-advanced-ruijian-zha": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-notion-mcp-advanced-ruijian-zha"
      ]
    }
  }
}

FAQ

Is this integration customizable?

Yes! Although originally designed for a specific database structure, you can modify the code to fit your own requirements.

What are the prerequisites for using this integration?

You need Python 3.10 or higher, a Notion account, an API key, and a matching database structure.

Are there any limitations?

The integration is limited to a specific Notion database structure and does not support complex schemas or additional properties.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":430,"uuid":"51ad547f-3dc0-465d-8fb7-9e75722d0aed","name":"Notion_MCP_advanced","title":"Notion MCP Integration","description":"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 structure, enabling efficient task management without unnecessary complexity.","avatar_url":"https://avatars.githubusercontent.com/u/55631456?v=4","created_at":"2024-12-16T07:23:46.002Z","updated_at":"2024-12-19T12:38:37.274Z","status":"created","author_name":"Ruijian-Zha","author_avatar_url":"https://avatars.githubusercontent.com/u/55631456?v=4","tags":"notion,task-management,mcp-integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/Ruijian-Zha/Notion_MCP_advanced","target":"_self","content":"$29","summary":"$2a","img_url":"https://github.com/Ruijian-Zha/Notion_MCP_advanced/raw/main/assets/demo.gif","type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools