Calendario de Google MCP

Un complemento de solicitud de finalización de modelo (MCP) para interactuar con Google Calendar.

Características

Crea eventos en Google Calendar con opciones personalizables:
- Horas de inicio y fin
- Descripción
- Ubicación
- Asistentes
- Zona horaria

Related MCP server: MCP Google Workspace Server

Instalación

Clonar este repositorio:

git clone https://github.com/ITworkonline/GoogleCalendarMCP.git
cd GoogleCalendarMCP

Cree un entorno virtual e instale dependencias:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
pip install -e .

Configurar la API de Google Calendar:
- Vaya a la consola de Google Cloud
- Crear un nuevo proyecto
- Habilitar la API de Google Calendar
- Crear credenciales OAuth 2.0 (aplicación de escritorio)
- Descargue el archivo JSON de credenciales y guárdelo como credentials.json en la raíz del proyecto

Uso

from GoogleCalendarMCP.main import create_event

# Create a calendar event
result = await create_event(
    summary="Meeting with Team",
    start_time="2025-04-01T10:00:00",
    end_time="2025-04-01T11:00:00",
    description="Discuss project progress",
    location="Conference Room 3",
    attendees=["colleague@example.com"],
    timezone="America/New_York"
)

Autenticación

La primera vez que ejecute el programa, se abrirá una ventana del navegador para que se autentique con su cuenta de Google. Tras la autenticación, se creará un archivo token.json para almacenar sus credenciales para futuras ejecuciones.