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
@modelcontextprotocol/sdk– Servidor y transporte MCPgoogleapis– Cliente de la API de Google Calendarzod– Validación de entradadotenv– Cargar archivos.env
🚀 Primeros Pasos
1. Clonar el repositorio
git clone https://github.com/your-username/mcp-calendar-tool.git
cd mcp-calendar-tool
- Instalar dependencias npm install
- Crear un archivo .env GOOGLE_API_KEY=tu_clave_de_api_de_google_calendar CALENDAR_ID=tu_id_o_correo_del_calendario
- 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