Google Calendar MCP Server

Servidor MCP de Google Calendar

Un potente servidor de Protocolo de contexto de modelo (MCP) que se integra con Google Calendar para proporcionar capacidades de gestión de calendario inteligentes y sensibles al contexto.

Características

• Gestión inteligente del calendario
  • Enumere y vea los próximos eventos con información detallada
  • Crea nuevos eventos con títulos, ubicaciones y asistentes personalizados.
  • Actualizar eventos existentes con nueva información
  • Eliminar eventos de tu calendario
  • Soporte para múltiples calendarios
• Operaciones sensibles al contexto
  • Mantiene el contexto entre las operaciones del calendario
  • Formato y visualización de eventos inteligentes
  • Autenticación segura y gestión de tokens
  • Manejo robusto de errores y validación

Prerrequisitos

• Node.js (v16 o superior)
• Cuenta de Google Cloud Platform
• API de Google Calendar habilitada
• Credenciales de OAuth 2.0 de Google Cloud Console

Configuración

1. Clonar el repositorio:
   git clone https://github.com/yourusername/google-calendar-mcp.git cd google-calendar-mcp
2. Instalar dependencias:
   npm install
3. Crea un archivo .env :
   cp .env.example .env
4. Actualice el archivo .env con sus credenciales de API de Google Calendar:
   • GOOGLE_CLIENT_ID : Su ID de cliente de Google Cloud Console
   • GOOGLE_CLIENT_SECRET : Su secreto de cliente de Google Cloud Console
   • GOOGLE_REDIRECT_URI : Su URI de redirección configurada
5. Construir el proyecto:
   npm run build
6. Iniciar el servidor:
   npm start

Ejemplos de uso

El servidor MCP admite varias operaciones de calendario a través de comandos de lenguaje natural:

Listado de eventos

• "Muéstrame mis próximos 5 eventos"
• "Enumerar todos los eventos de la próxima semana"
• "¿Qué hay en mi calendario para mañana?"

Creación de eventos

• "Programe una reunión con John y Sarah mañana a las 2 p.m."
• "Organiza un almuerzo con el equipo el próximo viernes a las 12 del mediodía".
• "Añadir cita médica para el próximo lunes a las 10h"

Actualizaciones de eventos

• "Pasar mi reunión de las 2 p. m. a las 3 p. m."
• "Agrega a Mike a la reunión de equipo de mañana"
• "Actualizar la ubicación de la reunión del viernes"

Eliminación de eventos

• Cancelar mi reunión de hoy a las 3 p. m.
• "Eliminar el almuerzo del equipo del próximo viernes"

Seguridad

• Todas las credenciales y tokens se almacenan de forma segura y no están sujetos al control de versiones.
• La autenticación OAuth 2.0 garantiza un acceso seguro a Google Calendar
• Las variables de entorno se utilizan para la configuración sensible.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.