Servidor OneNote MCP

Una implementación de servidor de Protocolo de contexto de modelo (MCP) para Microsoft OneNote, que permite que los modelos de lenguaje de IA interactúen con OneNote a través de una interfaz estandarizada.

Características

Gestión de cuadernos

• Listar todos los cuadernos

• Crear nuevos cuadernos

• Obtener detalles del cuaderno

• Eliminar cuadernos

Gestión de secciones

• Enumerar secciones en un cuaderno

• Crear nuevas secciones

• Obtener detalles de la sección

• Eliminar secciones

Gestión de páginas

• Listar páginas en una sección

• Crear nuevas páginas con contenido HTML

• Leer el contenido de la página

• Actualizar el contenido de la página

• Eliminar páginas

• Buscar páginas en los cuadernos

Related MCP server: onenote-mcp-server

Instalación

Instalación desde npm (recomendado)

npm install -g mcp-server-onenote

El paquete ahora está disponible en el registro npm a partir del 27 de abril de 2025.

Ejecutando el paquete

Después de la instalación, puede ejecutar el paquete usando:

mcp-server-onenote

O con npx:

npx mcp-server-onenote

Instalación mediante herrería

Para instalar OneNote Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @modelcontextprotocol/server-onenote --client claude

Instalación desde GitHub

npm install -g github:ZubeidHendricks/azure-onenote-mcp-server

Configuración

Establezca las siguientes variables de entorno:

• AZURE_TENANT_ID : Su identificador de inquilino de Azure

• AZURE_CLIENT_ID : Su ID de aplicación (cliente) de Azure

• AZURE_CLIENT_SECRET : Su secreto de cliente de Azure

Uso con el cliente MCP

Agregue esto a su configuración de cliente MCP (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "onenote": {
      "command": "mcp-server-onenote",
      "env": {
        "AZURE_TENANT_ID": "<YOUR_TENANT_ID>",
        "AZURE_CLIENT_ID": "<YOUR_CLIENT_ID>",
        "AZURE_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

Registro de aplicaciones de Azure

1. Vaya al Portal de Azure y navegue hasta Registros de aplicaciones

2. Crear un nuevo registro

3. Agregar permisos de la API de Microsoft Graph:

   • Notas.Lectura.Escritura.Todo

   • Notas.Leer.Todo

4. Crear un secreto de cliente

5. Copiar el ID del inquilino, el ID del cliente y el secreto del cliente para la configuración

Desarrollo

# Install dependencies
npm install

# Run tests
npm test

# Build
npm run build

# Lint
npm run lint

# Run locally
npm start

Contribuyendo

Consulte CONTRIBUTING.md para obtener información sobre cómo contribuir a este repositorio.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Registro de cambios

0.1.0 (27/04/2025)

• Lanzamiento inicial

• Funcionalidad principal para la gestión de cuadernos, secciones y páginas de OneNote

• Publicado en el registro npm

0.1.1 (27/04/2025)

• Se agregó el ejecutable bin al paquete.json

• Se solucionó el problema donde el comando npx no podía determinar el ejecutable a ejecutar

• README actualizado con instrucciones de ejecución claras