june-calendar-mcp

MCP de Google Calendar single-user (primary) sobre Streamable HTTP con autenticación por Service Account (JWT, sin caducidad OAuth). Pensado para un asistente personal.

Tools

create_event · move_event · update_event · delete_event · list_events · get_freebusy · find_free_slots · create_focus_block · get_agenda_today · get_next_event.

• Las fechas entran como ISO-8601 (el cliente/LLM las resuelve; el MCP no interpreta lenguaje natural).

• Los solapamientos se bloquean salvo allow_overlap: true (devuelve EVENT_CONFLICT).

• Idempotencia opcional con client_request_id.

Related MCP server: ical-mcp

Requisitos

1. Una Service Account de Google con la Calendar API habilitada; descarga su key JSON.

2. Comparte el calendario primary con el client_email de la SA (permiso "hacer cambios en eventos").

Variables de entorno

Ver .env.example. Clave: MCP_AUTH_TOKEN (Bearer del endpoint), GOOGLE_APPLICATION_CREDENTIALS_JSON (JSON de la SA, inline), CALENDAR_ID, TIMEZONE, ACTIVE_HOURS_WEEKDAY, ACTIVE_HOURS_WEEKEND, FOCUS_COLOR_ID.

Correr

npm install
PORT=8080 MCP_AUTH_TOKEN=... GOOGLE_APPLICATION_CREDENTIALS_JSON='{...}' node src/server.js
curl localhost:8080/health
node test/smoke.mjs     # lista tools por Streamable HTTP

Docker

docker build -t june-calendar-mcp .
docker run -p 8080:8080 --env-file .env june-calendar-mcp

El endpoint MCP queda en POST /mcp (requiere Authorization: Bearer <MCP_AUTH_TOKEN>); GET /health es abierto.