google-calendar-mcp-serviceaccount

Un servidor MCP mínimo que da a un agente de IA acceso de lectura/escritura a un Google Calendar, autenticado como cuenta de servicio en lugar de mediante OAuth interactivo.

Por qué una cuenta de servicio

La mayoría de los servidores MCP de Google Calendar usan OAuth: la aplicación pide a una persona que inicie sesión y conceda su consentimiento, como haría un producto multiusuario real. Para un asistente personal que solo necesita acceso a tu propio calendario, eso es más trámite del que el trabajo requiere: publicación en producción, dominios verificados, re-consentimiento periódico.

Una cuenta de servicio se salta todo eso: compartes tu calendario con la dirección de correo de la cuenta de servicio, exactamente igual que lo compartirías con otra persona. La credencial no caduca hasta que la revocas.

Contrapartida: solo funciona con calendarios que puedes compartir explícitamente por correo (cuentas personales de Google, la mayoría de configuraciones de Workspace): no puede actuar de forma amplia en la cuenta de un usuario como sí puede hacerlo una concesión OAuth completa.

Coste: a fecha de redacción de este documento, todo lo que se describe a continuación es gratuito: no es necesario vincular una cuenta de facturación ni una tarjeta de crédito al proyecto de Google Cloud. La cuota gratuita de la Calendar API supera con creces lo que un asistente personal llegará a usar. Esto podría cambiar en el futuro; consulta los precios actuales de Google Cloud si tienes dudas.

Related MCP server: Google Calendar MCP Server

Herramientas

No hay delete_event a propósito: añádelo tú mismo si quieres que un agente pueda eliminar entradas del calendario.

Configuración

¿Vas a configurar esto con la ayuda de un asistente de codificación de IA? Señálale AGENTS.md: contiene el paso a paso completo tanto para la parte humana como para la del agente.

Haciéndolo manualmente:

1. En Google Cloud Console: crea un proyecto, habilita la Calendar API, crea una cuenta de servicio (no un cliente OAuth) y descarga su clave JSON

2. Comparte tu Google Calendar con la dirección de correo de la cuenta de servicio, con el permiso "Hacer cambios en los eventos". Anota el ID del calendario: para tu propio calendario principal es simplemente tu dirección de correo; para cualquier otro calendario, encuéntralo en Configuración de ese calendario → "Integrar calendario" → "ID de calendario"

3. python3 -m venv venv && ./venv/bin/pip install -r requirements.txt

4. Copia .env.example a .env y rellena la ruta de la clave y tu ID de calendario

5. Registra calendar_server.py con tu cliente MCP como servidor stdio, pasando esas dos variables como su entorno

Licencia

MIT — consulta LICENSE.