MCP Google Calendar Integration

Se integra con la API de Google Calendar para obtener eventos del calendario de una fecha determinada.

Documentación

📅 Integración MCP de Google Calendar

Este proyecto es una herramienta de Protocolo de Contexto de Modelo (MCP) que se conecta con la API de Google Calendar para obtener eventos del calendario para una fecha determinada. Se integra perfectamente con editores impulsados por IA como Cursor para mejorar tu productividad al llevar datos de calendario en tiempo real directamente a tu entorno de codificación.


🔧 Características

  • 📆 Obtén eventos del calendario para una fecha específica
  • ⚡ Integración en tiempo real usando MCP
  • 🧠 Comandos de herramientas en lenguaje natural desde tu editor
  • ✅ Validación de esquema simple usando zod
  • 🔒 Utiliza variables de entorno para mantener segura la información sensible

📁 Estructura del Proyecto

/MCP_SERVER │ ├── server.js # Configuración del servidor MCP y herramienta de calendario ├── .env # Variables de entorno (no se incluyen en el repositorio) ├── package.json # Dependencias y scripts └── .mcp # Archivo de configuración MCP


📦 Tecnologías Utilizadas


🚀 Primeros Pasos

1. Clonar el repositorio

git clone https://github.com/your-username/mcp-calendar-tool.git
cd mcp-calendar-tool

  1. Instalar dependencias npm install
  2. Crear un archivo .env GOOGLE_API_KEY=tu_clave_de_api_de_google_calendar CALENDAR_ID=tu_id_o_correo_del_calendario
  3. Ejecutar el servidor npm start

Ejemplo de Uso (en Cursor)

🛠 Configuración MCP (.mcp)

{ "mcpServers": { "myCalenderData": { "command": "node", "args": ["server.js"], "env": { "GOOGLE_API_KEY": "tu_clave_de_api_aqui", "CALENDAR_ID": "tu_id_de_calendario_aqui" } } } }

🔐 Notas sobre el Acceso a la API

Asegúrate de que la API de Google Calendar esté habilitada en tu Consola de Google Cloud.

El calendario debe ser público o estar compartido adecuadamente si se usa una clave de API.

🧭 Mejoras Futuras

Agregar autenticación OAuth2 para múltiples usuarios

Soporte para eventos recurrentes y descripciones de eventos

Integrar Google Tasks y recordatorios

📄 Licencia

Este proyecto es de código abierto y está disponible bajo la Licencia MIT.

🙋‍♂️ Autor

Pranay Chowdhury Desarrollador Frontend | Entusiasta de MERN Stack LinkedIn • GitHub