Notion MCP Server

Servidor MCP de Notion

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración con los espacios de trabajo de Notion. Este servidor proporciona una interfaz estandarizada para que los modelos de IA accedan, consulten y modifiquen el contenido de Notion.

Prerrequisitos

• Node.js (v16 o superior)
• Clave API de Notion (de sus integraciones de Notion )
• Espacio de trabajo de Notion conectado con los permisos adecuados

Instalación

1. Clonar este repositorio:
   git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server
2. Instalar dependencias:
   npm install
3. Cree un archivo .env en el directorio raíz con su clave API de Notion:
   # Required NOTION_API_KEY=your_notion_api_key_here # Optional settings DEBUG=false REQUIRE_CONFIRMATION_FOR_CREATE=true REQUIRE_CONFIRMATION_FOR_UPDATE=true REQUIRE_CONFIRMATION_FOR_DELETE=true UPDATE_POLLING_INTERVAL=60000 MAX_BLOCK_DEPTH=3 BACKUP_DIR=./backups BACKUP_RETENTION_DAYS=30 MAX_BACKUPS_PER_PAGE=5
4. Construir el proyecto:
   npm run build
5. Iniciar el servidor:
   npm start

Uso con Claude para escritorio

Para utilizar este servidor Notion MCP con Claude for Desktop:

1. Asegúrese de que Claude for Desktop esté instalado y actualizado a la última versión
2. Abra el archivo de configuración de Claude for Desktop:
   • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • En Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Agregue la configuración del servidor:
   { "mcpServers": { "notion": { "command": "node", "args": ["/path/to/notion-mcp-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
4. Guarde el archivo y reinicie Claude for Desktop

Recursos

El servidor expone los siguientes recursos:

Herramientas

El servidor proporciona las siguientes herramientas:

Indicaciones

El servidor incluye estos mensajes preconfigurados:

Consultas de ejemplo

Una vez conectado a Claude, puedes hacer preguntas en lenguaje natural sobre tu espacio de trabajo de Notion:

1. "¿Qué tareas vencen hoy en mi espacio de trabajo?"
2. "Muéstrame el estado del Proyecto X"
3. Crear una nueva página en mi base de datos de ideas titulada "Nuevo concepto de función".
4. "Actualizar el estado de la tarea Y a 'Completada'"
5. "¿Qué cambios se realizaron en mi espacio de trabajo en las últimas 24 horas?"
6. "Resumir los próximos plazos para la próxima semana"
7. "Muéstrame todas las copias de seguridad de la página abc123"
8. Restaurar la página abc123 desde el archivo de copia de seguridad page_abc123_2023-01-01.json

Ampliación del servidor

Para agregar nueva funcionalidad:

1. Agregar recursos : amplíe los controladores de recursos en index.ts
2. Agregar herramientas : crea nuevas definiciones de herramientas en index.ts
3. Agregar indicaciones : define nuevas plantillas de indicaciones en index.ts
4. Mejorar la integración de API : agregar nuevas funciones de API en notion-api.ts

Registros

Consulte los registros del servidor para obtener información detallada sobre los errores:

• Registros de Claude para escritorio : busque en el directorio de registros de Claude los registros relacionados con MCP
• Salida del servidor : verifique la salida estándar y los flujos de error para los registros del servidor