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

Exposes the official Notion SDK, allowing interaction with Notion workspaces. Provides tools for searching, querying databases, creating and updating pages, managing content blocks, working with users, adding comments, and creating link previews.

Servidor MCP de Notion

Un servidor de Protocolo de contexto de modelo (MCP) que expone el SDK oficial de Notion, lo que permite que los modelos de IA interactúen con los espacios de trabajo de Notion.

Inicio rápido

1. Configure su integración de Notion

Vaya a https://www.notion.so/my-integrations
Crear una nueva integración
Copiar la clave API

2. Conecte sus páginas de Notion a la integración

Para que su integración acceda al contenido de Notion, debe compartir explícitamente sus páginas o bases de datos con él:

Navegue a la página de Notion o la base de datos a la que desea acceder a través de la integración
Haga clic en el botón "Compartir" en la esquina superior derecha.
En el campo "Agregar personas, grupos o integraciones", seleccione su integración de la lista desplegable
Haga clic en "Invitar"
Repita esto para cada página o base de datos que desee que sea accesible

Nota: Una integración solo tiene acceso a las páginas y bases de datos que se han compartido explícitamente con ella. Las páginas secundarias heredan automáticamente el acceso de las páginas principales.

3. Añade a tu asistente de IA

Puede agregar este servidor MCP a Claude Desktop, Cursor AI o Claude.ai utilizando cualquiera de estos formatos de configuración:

Formato de línea de comandos

npx @ramidecodes/mcp-server-notion@latest -y --api-key=your-notion-integration-key

Formato de configuración JSON

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Reemplace your-notion-integration-key con la clave API del paso 1.

Instrucciones de configuración

Claude Desktop : Configuración > Avanzado > Protocolo de contexto del modelo
Cursor AI : Configuración > AI > Servidores MCP
Claude.ai (Web) : Perfil > Configuración > API e integraciones > Protocolo de contexto del modelo

Herramientas disponibles

El servidor proporciona herramientas para interactuar con Notion:

Buscar : Encuentra páginas o bases de datos
Bases de datos : consultar y recuperar entradas de bases de datos
Páginas : crear, recuperar y actualizar páginas
Bloques : Administra bloques de contenido (párrafos, listas, etc.)
Usuarios : enumerar usuarios y obtener información de los mismos
Comentarios : crear y listar comentarios
Vistas previas de enlaces : crea vistas previas de enlaces para URL

Métodos de configuración alternativos

Uso de variables de entorno

En lugar de pasar la clave API directamente, puede utilizar un archivo .env :

Crea un archivo .env con:

NOTION_API_KEY=your-notion-integration-key

Ejecutar el servidor:

npx @ramidecodes/mcp-server-notion@latest -y

Configuración de JSON con variables de entorno (para Claude Desktop)

También puedes utilizar variables de entorno en el formato de configuración JSON:

{
  "mcpServers": {
    "Notion": {
      "command": "npx",
      "args": [
        "@ramidecodes/mcp-server-notion@latest",
        "-y",
        "--api-key=your-notion-integration-key"
      ]
    }
  }
}

Opciones de línea de comandos

OPTIONS:
  -h, --help              Show help message
  -v, --version           Show version information
  --verbose               Enable verbose logging
  --env-path <path>       Path to .env file
  --api-key <key>         Notion API key
  -y                      Skip confirmation prompts

Solución de problemas

Si encuentra errores de "Error al crear el cliente":

En Windows, intente usar cmd /c antes del comando npx
En macOS/Linux, intente usar la ruta completa a npx
Pruebe el comando en una terminal antes de agregarlo a su asistente de IA

Problemas comunes

Errores de "Sin acceso al recurso" : asegúrese de haber compartido la página o base de datos de Notion específica con su integración (consulte el paso 2)
La integración no aparece en el menú para compartir : intenta actualizar la página o reiniciar tu navegador
Capacidades limitadas : Verifique que su integración tenga las capacidades adecuadas habilitadas en la configuración de integración de Notion

Características

Compatibilidad total con la API de Notion a través del SDK oficial
Compatible con MCP para una integración perfecta con IA
Herramientas integrales para todas las operaciones de Notion
Manejo robusto de errores con mensajes detallados
Fácil configuración con variables de entorno

Para obtener documentación detallada sobre cada herramienta, consulte la Documentación de herramientas .

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0: consulte el archivo de LICENCIA para obtener más detalles.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools