Cómo conectar Microsoft To Do a Gemini vía MCP

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

Microsoft To Do + Gemini

Deja que tu IA gestione Microsoft To Do: muestra tus listas y tus tareas pendientes, crea tareas con fecha de vencimiento, aviso y notas, márcalas como completadas y añade pasos y enlaces. Cuentas de Microsoft profesionales, educativas y personales a través de Microsoft Graph.

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 Tasks.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 cuyas tareas debe gestionar 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_todo_list_lists: muestra tus listas de tareas, y la marcada como defaultList es tu lista estándar "Tareas".

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.

Cuentas personales y de trabajo: el conector funciona con cuentas personales de Microsoft y con cuentas profesionales o educativas. To Do comparte sus tareas con Outlook, así que las tareas que crea la IA también aparecen en Outlook y en Teams. Una cuenta profesional o educativa necesita un buzón de Exchange Online: sin él, Microsoft no le ofrece To Do.

Solo lectura: sustituye los scopes en los ajustes OAuth del conector por offline_access User.Read Tasks.Read, vuelve a autorizar y desactiva las herramientas que crean, cambian o completan algo: microsoft_todo_create_list, microsoft_todo_rename_list, microsoft_todo_create_task, microsoft_todo_update_task, microsoft_todo_complete_task, microsoft_todo_add_checklist_item, microsoft_todo_update_checklist_item y microsoft_todo_add_linked_resource. El conector de Microsoft Planner usa el mismo permiso Tasks.ReadWrite.

Los cambios esperan tu sí: antes de crear, cambiar o completar una lista, una tarea o un paso, la IA te dice qué va a hacer y espera tu sí.

Desactivadas al instalar: microsoft_todo_delete_task y microsoft_todo_delete_list. Eliminar una lista elimina todas sus tareas, y el conector no puede deshacer ninguna de las dos cosas, así que actívalas solo si la IA de verdad debe eliminar.

Listas, fechas y pasos: si no nombras una lista, la IA usa tu lista estándar "Tareas"; la lista de correo marcado contiene los correos que marcaste en Outlook. Para saber qué vence esta semana, la IA lista tus tareas pendientes y compara sus fechas de vencimiento. To Do guarda solo el día de la fecha de vencimiento, mientras que un aviso lleva una hora en tu zona horaria. Una tarea completada se puede volver a abrir. Cada tarea puede tener pasos y enlaces al ticket, documento o página web de la que trata.

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 significa que falta Tasks.ReadWrite o que no se dio el consentimiento, o que la lista está compartida contigo sin permiso de edición; un cambio con una configuración de solo lectura también acaba aquí. 404 significa que el id de la lista o de la tarea es incorrecto, que el elemento se eliminó o que la tarea se movió a otra lista (su id cambia al moverla). 400 significa que un valor tiene un formato incorrecto, por ejemplo una fecha sin zona horaria, o que la IA intentó cambiar el nombre de una lista integrada. 429 significa que Microsoft Graph está limitando la cuenta: espera un momento y vuelve a intentarlo.

El conector no gestiona archivos adjuntos en las tareas, no configura tareas periódicas, no comparte listas con otras personas y no abre las tareas de otros usuarios.

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 To Do.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué vence esta semana en mis listas de To Do? Muéstrame primero las tareas importantes."
• "Añade a mi lista Trabajo la tarea Enviar la oferta del T4 a Acme, con vencimiento el viernes y un aviso el jueves a las 9:00."
• "Añade a esa tarea los pasos Revisar precios, Redactar la carta de presentación y Conseguir la aprobación."
• "Marca como completada Reservar vuelos a Hamburgo y añade el enlace de la reserva del hotel a la tarea Hotel Hamburgo."

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