Servidor MCP de Notion

noción-mcp-sm

Este proyecto implementa un servidor MCP para la API de Notion .

demostración de mcp

Instalación

1. Configuración de la integración en Notion:

Vaya a https://www.notion.so/profile/integrations y cree una nueva integración interna o seleccione una existente.

Creación de un token de integración de Notion

Si bien limitamos el alcance de la exposición de las API de Notion (por ejemplo, no podrá eliminar bases de datos mediante MCP), existe un riesgo considerable para los datos del espacio de trabajo al exponerlos a los LLM. Los usuarios preocupados por la seguridad deberían configurar mejor las capacidades de la integración.

Por ejemplo, puede crear un token de integración de solo lectura otorgando únicamente acceso a "Leer contenido" desde la pestaña "Configuración":

Capacidades del token de integración de Notion que muestran contenido leído marcado

2. Conectar el contenido con la integración:

Asegúrese de que las páginas y bases de datos relevantes estén conectadas a su integración.

Para hacer esto, deberá visitar esa página, hacer clic en los 3 puntos y seleccionar "Conectar a la integración".

Agregar un token de integración a las conexiones de Notion

3. Agregar configuración MCP a su cliente:

Usando npm:

Agregue lo siguiente a su .cursor/mcp.json o claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json )

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Usando Docker:

Hay dos opciones para ejecutar el servidor MCP con Docker:

Opción 1: Usar la imagen oficial de Docker Hub:

Agregue lo siguiente a su .cursor/mcp.json o claude_desktop_config.json :

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

Este enfoque:

Utiliza la imagen oficial de Docker Hub
Maneja adecuadamente el escape JSON a través de variables de entorno
Proporciona un método de configuración más confiable

Opción 2: Construir la imagen de Docker localmente:

También puedes compilar y ejecutar la imagen de Docker localmente. Primero, compila la imagen de Docker:

docker-compose build

Luego, agrega lo siguiente a tu .cursor/mcp.json o claude_desktop_config.json :

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server"
      ]
    }
  }
}

No olvides reemplazar ntn_**** con tu secreto de integración. Puedes encontrarlo en la pestaña de configuración de la integración:

Copiar su token de integración desde la pestaña Configuración en el portal para desarrolladores

Ejemplos

Usando la siguiente instrucción

Comment "Hello MCP" on page "Getting started"

La IA planificará correctamente dos llamadas API, v1/search y v1/comments , para lograr la tarea.

De manera similar, la siguiente instrucción generará una nueva página llamada "Notion MCP" agregada a la página principal "Desarrollo".

Add a page titled "Notion MCP" to page "Development"

También puede hacer referencia directamente al ID de contenido

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Desarrollo

Construir

npm run build

Ejecutar

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Publicar

npm publish --access public

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Un servidor MCP que permite a los asistentes de IA interactuar con la API de Notion, lo que les permite buscar, leer, comentar y crear contenido en los espacios de trabajo de Notion a través de comandos de lenguaje natural.

Related MCP Servers

Notion MCP Server
suekou
A
security
A
license
A
quality
MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
1,230
699
TypeScript
MIT License
SystemPrompt MCP Notion Server
Ejb503
A
security
F
license
A
quality
A high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.
Last updated -
8
10
13
TypeScript
Notion MCP Server
ramidecodes
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.
Last updated -
17
77
7
TypeScript
Apache 2.0
notion-mcp-server
awkoy
A
security
A
license
A
quality
Notion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.
Last updated -
13
194
91
TypeScript
MIT License

View all related MCP servers

Notion MCP Server