Notion

Integra con espacios de trabajo de Notion para gestionar bases de datos, páginas y contenido.

Documentación

Notion MCP Server

Un servidor de Model Context Protocol (MCP) para integrarse con espacios de trabajo de Notion. Este servidor proporciona una interfaz estandarizada para que los modelos de IA accedan, consulten y modifiquen contenido en Notion.

Requisitos previos

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

Instalación

Clona este repositorio:

git clone https://github.com/yourusername/notion-mcp-server.git
cd notion-mcp-server

Instala las dependencias:
```
npm install
```

Crea un archivo .env en el directorio raíz con tu clave de 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

Compila el proyecto:
```
npm run build
```
Inicia el servidor:
```
npm start
```

Uso con Claude for Desktop

Para usar este servidor MCP de Notion con Claude for Desktop:

Asegúrate de que Claude for Desktop esté instalado y actualizado a la última versión
Abre 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

Añade 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"
      }
    }
  }
}

Guarda el archivo y reinicia Claude for Desktop

Recursos

El servidor expone los siguientes recursos:

URI del recurso	Descripción
`notion://databases`	Lista todas las bases de datos del 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/ítems 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:

Prompts

El servidor incluye estos prompts preconfigurados:

Nombre del prompt	Descripción
`upcoming-deadlines`	Obtener una lista de próximos plazos
`project-status`	Resumir el estado de un proyecto
`daily-tasks`	Obtener 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"
"Crea una nueva página en mi base de datos 'Ideas' con el título 'Nuevo Concepto de Funcionalidad'"
"Actualiza el estado de la tarea Y a 'Completada'"
"¿Qué cambios se hicieron en mi espacio de trabajo en las últimas 24 horas?"
"Resume los próximos plazos para la próxima semana"
"Muéstrame todas las copias de seguridad de la página abc123"
"Restaura la página abc123 desde el archivo de copia de seguridad page_abc123_2023-01-01.json"

Extender el servidor

Para añadir nueva funcionalidad:

Añadir recursos: Extiende los manejadores de recursos en index.ts
Añadir herramientas: Crea nuevas definiciones de herramientas en index.ts
Añadir prompts: Define nuevas plantillas de prompts en index.ts
Mejorar la integración con la API: Añade nuevas funciones de API en notion-api.ts

Registros

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

Registros de Claude for Desktop: Busca en el directorio de registros de Claude los registros relacionados con MCP
Salida del servidor: Revisa los flujos de salida estándar y de error para los registros del servidor