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

Related MCP server: Notion MCP Server

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

2. Configurar el entorno de Python:

uv venv
source .venv/bin/activate
uv pip install -e .

3. Crear una integración de Notion:

   • Vaya a https://www.notion.so/my-integrations

   • Crear nueva integración

   • Copiar la clave API

4. 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

2. 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"

3. 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.