Google Calendar MCP

Google Calendar MCP

Resumen

Es un servidor MCP stdio que se integra con Google Calendar. Puede consultar, crear y ver detalles de eventos mediante el protocolo MCP desde Cursor, entre otros. La autenticación utiliza Google OAuth2.

Funciones principales

• Integración con la API de Google Calendar
• Proporciona funciones de consulta, creación y visualización de detalles de eventos como servidor MCP stdio
• Manejo de autenticación con Google OAuth2

---

Stack tecnológico

• Python 3.13 o superior (recomendado: 3.13.3)
• Gestor de paquetes: uv
• Servidor MCP: fastmcp
• Integración con Google API: google-api-python-client, google-auth, google-auth-oauthlib
• Autenticación: OAuth2 (Google)

---

Funciones implementadas y métodos MCP

Función	Método MCP	Descripción
Ver eventos del mes	list_month_events	Consulta la lista de todos los eventos del año/mes especificado
Ver eventos de un día	list_day_events	Consulta la lista de todos los eventos de la fecha especificada
Ver detalle de un evento	get_event_detail	Consulta información detallada por ID de evento
Crear evento	create_event	Crea un nuevo evento (se pueden agregar participantes (correos electrónicos))
Actualizar evento	update_event	Actualiza la información del evento por ID (título, hora, etc.)
Eliminar evento	delete_event	Elimina un evento por ID
Buscar espacios libres	find_free_slots	Busca espacios de tiempo libres de N minutos o más en una fecha específica (útil para coordinar reuniones)

---

1. Instalación de uv (solo la primera vez)

macOS/Homebrew

brew install uv

O script de instalación oficial

curl -Ls https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

iwr -useb https://astral.sh/uv/install.ps1 | iex

2. Descarga del paquete MCP

git clone https://github.com/AnByoungHyun/google_calendar_mcp.git
cd google_calendar_mcp

3. Instalación de paquetes

uv sync

• Con el comando anterior, todos los paquetes se instalan automáticamente.

4. Ejemplo de registro en Cursor MCP

Ejemplo de .cursor/mcp.json:

{
  "mcpServers": {
    ...
    "google-calendar": {
      "command": "uv",
      "args": ["--directory", "<google_calendar_mcp_path>", "run", "google_calendar_mcp"]
    }
  }
}

---

Referencias y contacto

• Documentación oficial de la API de Google Calendar: https://developers.google.com/calendar/api
• Documentación de MCP/fastmcp: https://github.com/anysphere/fastmcp

No se necesitan comandos adicionales de entorno virtual/venv. uv crea automáticamente un entorno seguro. Si tiene preguntas durante la instalación o ejecución, ¡no dude en contactarnos!