Skip to main content
Glama
enesjakozh

Notion MCP Server

by SAhmadUmass
npmGitHub
TypeScript
184
3
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Servidor MCP de Notion

Un servidor de protocolo de contexto de modelo para la integración de Notion, que permite a Claude y otros LLM interactuar con su espacio de trabajo de Notion.

Características

  • Buscar en Notion : busca en todo tu espacio de trabajo de Notion

  • Obtener página : recupera contenido de una página específica de Notion

  • Crear página : crea nuevas páginas en tu espacio de trabajo de Notion

  • Actualizar página : Actualizar páginas existentes con nuevo contenido o títulos

  • Crear base de datos : crea nuevas bases de datos con propiedades personalizadas

  • Consulta de base de datos : consulta bases de datos con filtros y ordenación

  • Actualizar entrada de base de datos : Actualizar las propiedades de las entradas de la base de datos

  • Crear fila de base de datos : agregue nuevas filas a bases de datos existentes con propiedades personalizadas

Configuración

  1. Clonar este repositorio

  2. Instalar dependencias

    npm install

  3. Configura tu clave API de Notion

    • Crear una integración en el portal de Notion Developers

    • Copia tu clave API

    • Puedes:

      • Edite el archivo .env y reemplace your_notion_api_key_here con su clave API real, o

      • Páselo directamente en la configuración de Claude for Desktop (recomendado, ver más abajo)

  4. Construir el servidor

    npm run build

  5. Ejecutando el servidor

    npm start

Configuración con Claude para escritorio

  1. Instalar Claude para escritorio (si aún no está instalado)

  2. Abra la configuración de la aplicación Claude para escritorio:

    • En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Crea el archivo si no existe

  3. Añade el servidor Notion a tu configuración:

    { "mcpServers": { "notion": { "command": "node", "args": [ "/Users/shaheerahmad/Documents/notion-mcp-server/dist/index.js", "--notion-api-key=YOUR_ACTUAL_API_KEY_HERE" ] } } }

    Reemplazar:

    • /Users/shaheerahmad/Documents/notion-mcp-server con la ruta completa al directorio de su proyecto

    • YOUR_ACTUAL_API_KEY_HERE con su clave API de Notion real

  4. Reiniciar Claude para escritorio

Usando el servidor

Una vez conectado a Claude for Desktop, puedes usar el servidor haciéndole a Claude preguntas como:

  • Buscar notas de reuniones en mi espacio de trabajo de Notion

  • "Obtener el contenido de mi página de planificación de proyectos" (necesitará el ID de la página)

  • Crear una nueva página en Notion con una lista de tareas

  • "Actualizar mi página de Notion con ID 1aaada269d1b8003adceda69cf7bcd97 con el texto 'Aquí hay contenido nuevo para agregar a la página'".

  • Crear una nueva base de datos en mi página de Notion con el ID 1aaada269d1b8003adceda69cf7bcd97

  • Consultar mi base de datos de Notion con el ID 1aaada269d1b8003adceda69cf7bcd97 para elementos con estado 'Completado'.

Claude utilizará automáticamente las herramientas adecuadas en función de su solicitud.

Ejemplos de uso de herramientas

Noción de búsqueda

Search for "meeting notes" in my Notion workspace

Obtener contenido de la página

Get the content of my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97

Crear una nueva página

Create a new page in Notion with title "Weekly Report" and content "This week we accomplished the following tasks..."

Actualizar una página existente

Update my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97 with content "Adding this new information to the page."

También puedes actualizar el título:

Update my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97 with title "New Title" and content "New content to add."

Crear una nueva base de datos

Create a new database in my Notion page with ID 1aaada269d1b8003adceda69cf7bcd97 with title "Task Tracker" and properties { "Task Name": { "title": {} }, "Status": { "select": { "options": [ { "name": "Not Started", "color": "red" }, { "name": "In Progress", "color": "yellow" }, { "name": "Completed", "color": "green" } ] } }, "Priority": { "select": { "options": [ { "name": "Low", "color": "blue" }, { "name": "Medium", "color": "yellow" }, { "name": "High", "color": "red" } ] } }, "Due Date": { "date": {} } }

Consultar una base de datos

Query my Notion database with ID 1aaada269d1b8003adceda69cf7bcd97 with filter { "property": "Status", "select": { "equals": "Completed" } }

También puedes agregar ordenación:

Query my Notion database with ID 1aaada269d1b8003adceda69cf7bcd97 with sort { "property": "Due Date", "direction": "ascending" }

Actualizar entrada de la base de datos

Actualizar las propiedades de una entrada de base de datos existente (página dentro de una base de datos).

{ "tool_name": "update-database-entry", "tool_params": { "pageId": "page_id_of_database_entry", "properties": { "Status": { "select": { "name": "Completed" } }, "Priority": { "select": { "name": "High" } }, "Due Date": { "date": { "start": "2023-12-31" } } } } }

El parámetro properties debe coincidir con la estructura esperada por la API de Notion para los tipos de propiedad específicos de su base de datos. Los diferentes tipos de propiedad (texto, selección, fecha, etc.) requieren formatos diferentes.

Crear fila de base de datos

Agregar una nueva fila a una base de datos existente con propiedades personalizadas.

{ "tool_name": "create-database-row", "tool_params": { "databaseId": "your_database_id_here", "properties": { "Name": { "title": [ { "text": { "content": "New Task" } } ] }, "Status": { "select": { "name": "Not Started" } }, "Priority": { "select": { "name": "Medium" } }, "Due Date": { "date": { "start": "2023-12-15" } }, "Notes": { "rich_text": [ { "text": { "content": "This is a new task created via the API" } } ] } } } }

El parámetro properties debe incluir todas las propiedades requeridas para la base de datos y seguir la estructura de la API de Notion para cada tipo de propiedad.

Solución de problemas

  • Si no aparecen las herramientas, consulte los registros de Claude for Desktop:

    tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

  • Asegúrese de que su clave API de Notion esté configurada correctamente y que su integración tenga acceso a las páginas con las que desea interactuar.

  • Si ve errores de "Token inesperado" en los registros, es probable que las sentencias console.log interfieran con el protocolo MCP. Esta versión del servidor se ha actualizado para evitar estos problemas.

Mejoras futuras

  • Agregar capacidades de consulta de base de datos

  • Implementar un mejor formato de contenido

  • Añadir soporte para más tipos de bloques

Deploy Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Un servidor de protocolo de contexto de modelo que permite a Claude y otros LLM interactuar con los espacios de trabajo de Notion, proporcionando capacidades como buscar, recuperar, crear y actualizar páginas, así como administrar bases de datos.

  1. Características
    1. Configuración
      1. Configuración con Claude para escritorio
        1. Usando el servidor
          1. Ejemplos de uso de herramientas
        2. Solución de problemas
          1. Mejoras futuras

            Related Resources

            Related MCP Servers

            • Notion MCP

              Badhansen
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
              Last updated -
              23
              MIT License

            • Notion MCP Server

              ccabanillas
              -
              security
              A
              license
              -
              quality
              A Model Context Protocol server that provides a standardized interface for interacting with Notion's API, enabling users to list databases, create pages, and search across their Notion workspace.
              Last updated -
              109
              MIT License
              • Apple

            • Notion MCP Server

              Sjotie
              A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that connects Claude and other AI assistants to your Notion workspace, allowing AIs to interact with databases, pages, and blocks.
              Last updated -
              12
              0
              11
              • Apple

            • Notion MCP Server

              emmanuelsystems
              A
              security
              F
              license
              A
              quality
              A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
              Last updated -
              12
              184
              1
              • Apple

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/SAhmadUmass/notion-mcp-server'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server