Cómo conectar Microsoft OneNote a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → OneNote (Microsoft 365), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Microsoft OneNote + Gemini

Deja que tu IA trabaje en OneNote: explora blocs de notas, secciones y páginas, lee páginas, crea blocs de notas, secciones y páginas, y añade notas a páginas existentes. OneNote para el trabajo o la escuela y OneNote personal a través de Microsoft Graph, con el inicio de sesión de tu cuenta de Microsoft.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Paso 1 — Obtener credenciales

1. Abre el centro de administración de Microsoft Entra (entra.microsoft.com) o el portal de Azure y ve a Applications → App registrations → New registration.

2. Ponle un nombre a la app (por ejemplo "AnythingMCP Microsoft 365") y elige los Supported account types. La elección decide qué va en MICROSOFT_TENANT_ID:

   • Accounts in this organizational directory only (un solo inquilino): solo pueden iniciar sesión los usuarios de tu organización. Usa el Directory (tenant) ID de la página Overview de la app (un GUID) o tu dominio, por ejemplo contoso.onmicrosoft.com.
   • Accounts in any organizational directory (multiinquilino): usa organizations.
   • Accounts in any organizational directory and personal Microsoft accounts: usa common (cuentas profesionales, educativas y personales) o consumers (solo cuentas personales).

   Si el valor no coincide con el tipo de cuenta, Microsoft rechaza el inicio de sesión (AADSTS50194 o AADSTS50020).

3. En Redirect URI elige la plataforma Web e introduce https://cloud.anythingmcp.com/api/mcp-oauth/callback. Si alojas AnythingMCP tú mismo, introduce en su lugar https://tu-host-anythingmcp/api/mcp-oauth/callback. El URI debe coincidir carácter por carácter; si no, Microsoft responde AADSTS50011.

4. Abre API permissions → Add a permission → Microsoft Graph → Delegated permissions y añade offline_access, User.Read y Notes.ReadWrite. offline_access hace que Microsoft emita un refresh token; sin él, el conector deja de funcionar una hora después de autorizarlo.

5. Abre Certificates & secrets → New client secret. Copia el Value del secreto, no el Secret ID; solo se muestra una vez. Anota la fecha de caducidad: cuando el secreto caduca, el conector deja de funcionar hasta que crees uno nuevo y lo pegues.

6. Pega el Application (client) ID de la página Overview en MICROSOFT_CLIENT_ID, el valor del secreto en MICROSOFT_CLIENT_SECRET y el valor del inquilino del paso 2 en MICROSOFT_TENANT_ID, e instala el conector.

7. En la página del conector, haz clic en Authorize with Provider e inicia sesión con la cuenta cuyos blocs de notas debe usar la IA. El refresh token se guarda cifrado y los access tokens (válidos durante una hora aproximadamente) se renuevan automáticamente.

8. Empieza con microsoft_onenote_list_notebooks: muestra los blocs de notas que el conector puede abrir y tu rol en cada uno (propietario, colaborador o lector).

Una sola app de Entra para todos los conectores de Microsoft: el registro de app que creaste para el conector de Outlook, OneDrive, SharePoint o Excel también sirve aquí. Ábrelo, añade el permiso del paso 4 en API permissions, conserva el mismo URI de redirección y reutiliza el mismo ID de cliente, el mismo secreto y el mismo inquilino. Cada conector pide solo sus propios permisos cuando lo autorizas:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (más Files.ReadWrite.All para libros en SharePoint o compartidos contigo)
• SharePoint: Sites.ReadWrite.All y Files.ReadWrite.All
• OneNote: Notes.ReadWrite
• Microsoft To Do: Tasks.ReadWrite
• Planner: Tasks.ReadWrite

Todos necesitan además offline_access y User.Read.

Consentimiento del administrador: estos permisos delegados normalmente no necesitan un administrador, pero muchas organizaciones desactivan el consentimiento de los usuarios. Si el inicio de sesión muestra "Need admin approval" (AADSTS65001 o AADSTS90094), un administrador del inquilino abre una vez el registro de la app y hace clic en API permissions → Grant admin consent para la organización. Después, cualquier usuario puede autorizar. Cada conector sigue trabajando solo con lo que puede ver la cuenta que inició sesión.

Blocs de notas compartidos contigo: Notes.ReadWrite cubre tus propios blocs de notas. Para trabajar en blocs de notas que tus compañeros compartieron contigo (cuentas profesionales o educativas), añade Notes.ReadWrite.All al registro de la app, sustituye con él Notes.ReadWrite en los ajustes OAuth del conector y vuelve a autorizar.

Solo lectura: sustituye los scopes en los ajustes OAuth del conector por offline_access User.Read Notes.Read, vuelve a autorizar y desactiva microsoft_onenote_create_notebook, microsoft_onenote_create_section, microsoft_onenote_create_page, microsoft_onenote_append_to_page y microsoft_onenote_update_page.

Los cambios esperan tu sí: antes de crear un bloc de notas, una sección o una página, o de cambiar una página, la IA te dice qué va a escribir y dónde, y espera tu sí.

Desactivada al instalar: microsoft_onenote_delete_page. El conector no puede deshacer una eliminación, así que actívala solo si la IA de verdad debe eliminar páginas.

Buscar y leer páginas: un bloc de notas contiene secciones, que pueden estar agrupadas en grupos de secciones, y cada sección contiene páginas. La IA puede buscar en los títulos de las páginas y filtrar por la fecha del último cambio, pero Microsoft Graph no busca en el texto de las páginas, así que la IA abre las páginas que encajan y las lee. Las imágenes de una página solo se abren con tu inicio de sesión, la entrada de lápiz no se incluye y las páginas muy largas se cortan hacia los 200 KB. Si tienes muchísimos elementos en OneNote, la lista de páginas de todos los blocs de notas puede fallar con el error 10008; entonces la IA va sección por sección.

Escribir páginas: las páginas nuevas admiten un formato sencillo: títulos, listas, tablas, enlaces, casillas de tareas pendientes e imágenes desde una dirección web pública. microsoft_onenote_append_to_page es la forma más fácil de añadir notas al final de una página. Una página nueva necesita unos segundos antes de que OneNote acepte cambios: si añadir algo justo después de crearla responde 404, la IA espera un poco y lo vuelve a intentar.

Errores frecuentes: 401 InvalidAuthenticationToken significa que la autorización se revocó o que el client secret caducó; pega un secreto nuevo si hace falta y vuelve a hacer clic en Authorize with Provider. 403 (código 40004 o 40002) significa que falta Notes.ReadWrite o que no se dio el consentimiento, o que el bloc de notas está compartido contigo en solo lectura. 404 (o código 20102 o 20112) significa que el id es incorrecto o que el elemento se eliminó. 20117 significa que ya existe ahí un bloc de notas o una sección con ese nombre; 20115, 20153 o 20155 significan que el nombre tiene un carácter no permitido o es demasiado largo (128 caracteres para blocs de notas, 50 para secciones). 30105 o 30108 significan que tu OneDrive para la Empresa aún no está configurado: abre OneDrive una vez o pide a tu administrador que revise tu licencia. 429 significa que Microsoft Graph está limitando la cuenta: espera un momento y vuelve a intentarlo.

El conector no sube imágenes ni archivos a las páginas, no trabaja con la entrada de lápiz, no copia páginas ni secciones y no abre los blocs de notas de grupos de Microsoft 365 ni de sitios de SharePoint.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Microsoft OneNote.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué blocs de notas de OneNote tengo y qué secciones hay en mi bloc Trabajo?"
• "Busca mis páginas del último mes con presupuesto en el título y resume lo que dicen."
• "Crea en la sección Reuniones una página Kickoff Acme con estas notas y una casilla de tarea para cada punto pendiente."
• "Añade a la página Llamada proveedor: el viernes volver a llamar a Ana por la fecha de entrega."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse