Servidor MCP de Notion

Un servidor que se conecta a la API de Notion y expone la funcionalidad a través del Protocolo de contexto de máquina (MCP) de Claude.

Características

• Buscar páginas de Notion por título o contenido

• Recuperar detalles y contenido de la página

• Consultar bases de datos de Notion

• Crear nuevas páginas en Notion

Related MCP server: Notion MCP Server

Configuración

1. Clonar este repositorio:

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

2. Instalar dependencias:

npm install

3. Cree un archivo .env en el directorio raíz con el siguiente contenido:

NOTION_API_KEY=your_notion_api_key_here
PORT=3000
# Optional: if you want to query a specific database by default
NOTION_DATABASE_ID=your_notion_database_id_here

4. Obtenga su clave API de Notion:

   • Vaya a https://www.notion.so/my-integrations

   • Crear una nueva integración

   • Copiar el "Token de integración interna"

   • Agregue este token como su NOTION_API_KEY en el archivo .env

5. Conecte su integración de Notion a su espacio de trabajo:

   • Vaya a una página o base de datos en su espacio de trabajo de Notion

   • Haga clic en el menú "..." en la parte superior derecha

   • Seleccione "Agregar conexiones"

   • Encuentra y agrega tu integración

Ejecución del servidor

Inicie el servidor en modo de desarrollo:

npm run dev

O en modo de producción:

npm start

El servidor se ejecutará en el puerto especificado en su archivo .env (predeterminado: 3000).

Puntos finales de API

Puntos finales HTTP regulares

• POST /api/notion/búsqueda

  • Buscar páginas en Notion

  • Cuerpo: { "query": "search term" }

• POST /api/notion/página

  • Obtener una página por ID

  • Cuerpo: { "page_id": "page-id-here" }

• POST /api/notion/base de datos/consulta

  • Consultar una base de datos

  • Cuerpo: { "database_id": "database-id-here", "filter": {}, "sorts": [] }

• POST /api/notion/página/crear

  • Crear una nueva página

  • Cuerpo: { "parent": {}, "properties": {}, "children": [] }

Integración MCP

El servidor expone un manifiesto MCP en /mcp/manifest.json que describe las funciones disponibles.

Para invocar una función MCP, envíe una solicitud POST a /api/notion/mcp/invoke con la siguiente estructura:

{
  "function_name": "search_pages",
  "parameters": {
    "query": "search term"
  }
}

Funciones MCP disponibles

• search_pages - Buscar páginas de Notion por título o contenido

• get_page - Obtener una página de Notion por ID

• query_database - Consultar una base de datos de Notion

• create_page - Crea una nueva página en Notion

Licencia

Instituto Tecnológico de Massachusetts (MIT)