Notion MCP

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Integrates with Notion's API to manage personal todo lists, providing functions to show all tasks, add new tasks, and update existing tasks in a Notion workspace.

noción-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) simple que se integra con la API de Notion para administrar mi lista de tareas personales.

Manifestación

Guía visual

Consulta 1 de Notion MCP

Consulta MCP 2 de Notion

Consulta MCP 3 de Notion

Prerrequisitos

  • Python 3.11 o superior
  • Una cuenta de Notion con acceso a la API
  • Un token de integración de Notion
  • Una página de Notion donde quieres administrar tu lista de tareas pendientes
  • Claude Desktop Clint

Configuración

Instalación mediante herrería

Para instalar Notion MCP para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude
  1. Clonar el repositorio:
git clone https://github.com/Badhansen/notion-mcp.git cd notion-mcp
  1. Configurar el entorno de Python:
uv venv source .venv/bin/activate uv pip install -e .
  1. Crear una integración de Notion:
  2. Comparte tu base de datos/página con la integración:
    • Abra su espacio de trabajo de nociones con una base de datos/tabla presente o una página.
    • Haga clic en el menú "..." → "Agregar conexiones"
    • Seleccione su integración (Buscar por nombre)

Configuración

  1. Crear archivo .env :
cp .env.example .env
  1. Configurar las credenciales de Notion en .env :
NOTION_TOKEN=<your-notion-api-token> PAGE_ID=<your-notion-page-id> NOTION_VERSION="2022-06-28" NOTION_BASE_URL="https://api.notion.com/v1"
  1. Para usarlo con Claude Desktop correctamente, debe ajustar el archivo claude_desktop_config.json . Vaya a Claude Desktop -> Settings -> Developer -> Edit Config . Ahora, agregue la configuración del servidor Notion .
{ "mcpServers": { "notion-mcp": { "command": "uv", "args": [ "--directory", "/Users/username/Projects/Python/notion-mcp/src" /* Path to your project */, "run", "server.py" ] } } }

Desarrollo

Estructura del proyecto:

notion-mcp/ ├── docs/ ├── src/ │ └── server.py ├── .env ├── .python-version ├── README.md ├── pyproject.toml └── uv.lock

Funciones de soporte

Mostrar tareas

Para mostrar todas las tareas de su espacio de trabajo de Notion, utilice la función show_all_todos :

{ "name": "show_all_todos", "arguments": {} }

Agregar tarea

Para agregar una nueva tarea a su espacio de trabajo de Notion, utilice la función add_todo :

{ "name": "add_todo", "arguments": { "task": "Your task description" } }

Actualizar tarea

Para actualizar una tarea existente en su espacio de trabajo de Notion, utilice la función complete_todo :

{ "name": "complete_todo", "arguments": { "task_id": "your-task-id" } }

Contribuyendo

  1. Bifurcar el repositorio
  2. Crear rama de características
  3. Enviar solicitud de extracción

Licencia

Licencia MIT. Consulte el archivo de LICENCIA para obtener más detalles.

-
security - not tested
A
license - permissive license
-
quality - not tested

Un servidor de protocolo de contexto de modelo que se integra con la API de Notion para administrar listas de tareas personales, lo que permite a los usuarios ver, agregar y actualizar tareas directamente desde Claude.

  1. Demo
    1. Visual Guide
      1. Notion MCP Query 1
      2. Notion MCP Query 2
      3. Notion MCP Query 3
    2. Prerequisites
      1. Setup
        1. Installing via Smithery
      2. Configuration
        1. Development
          1. Support Functions
            1. Show Tasks
            2. Add Task
            3. Update Task
          2. Contributing
            1. License
              ID: 02p0quowuj