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

Related MCP server: Notion MCP Server

Instalación

Clonar este repositorio:
git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server
Instalar dependencias:
npm install
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
Construir el proyecto:
npm run build
Iniciar el servidor:
npm start

Uso con Claude para escritorio

Para utilizar este servidor Notion MCP con Claude for Desktop:

Asegúrese de que Claude for Desktop esté instalado y actualizado a la última versión
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
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" } } } }
Guarde el archivo y reinicie Claude for Desktop

Recursos

El servidor expone los siguientes recursos:

URI del recurso	Descripción
`notion://databases`	Enumera todas las bases de datos en el espacio de trabajo
`notion://databases/{databaseId}/schema`	Recupera el esquema de una base de datos específica
`notion://databases/{databaseId}/content`	Recupera todas las páginas/elementos de una base de datos específica
`notion://pages/{pageId}`	Recupera el contenido de una página específica
`notion://updates`	Recupera actualizaciones y cambios recientes en el espacio de trabajo.

Herramientas

El servidor proporciona las siguientes herramientas:

Indicaciones

El servidor incluye estos mensajes preconfigurados:

Nombre del aviso	Descripción
`upcoming-deadlines`	Obtenga una lista de las próximas fechas límite
`project-status`	Resumir el estado de un proyecto
`daily-tasks`	Obtenga una lista de tareas para hoy

Consultas de ejemplo

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

"¿Qué tareas vencen hoy en mi espacio de trabajo?"
"Muéstrame el estado del Proyecto X"
Crear una nueva página en mi base de datos de ideas titulada "Nuevo concepto de función".
"Actualizar el estado de la tarea Y a 'Completada'"
"¿Qué cambios se realizaron en mi espacio de trabajo en las últimas 24 horas?"
"Resumir los próximos plazos para la próxima semana"
"Muéstrame todas las copias de seguridad de la página abc123"
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:

Agregar recursos : amplíe los controladores de recursos en index.ts
Agregar herramientas : crea nuevas definiciones de herramientas en index.ts
Agregar indicaciones : define nuevas plantillas de indicaciones en index.ts
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