Google Calendar

📅 Servidor MCP de Google Calendar

¡Un potente servidor de Model Context Protocol (MCP) que permite a Claude interactuar con tu Google Calendar sin problemas!

Convierte a Claude en tu asistente personal de calendario con integración completa de Google Calendar. Crea reuniones, consulta horarios, gestiona eventos y más, todo mediante conversación natural con Claude.

🌟 ¿Qué puede hacer esto?

✨ Gestión inteligente del calendario

• 📋 Ver todos tus calendarios - Ve todos los calendarios a los que tienes acceso
• 📅 Consulta tu horario - Obtén los eventos de hoy o los próximos eventos para cualquier período
• 🎯 Crea reuniones al instante - Configura eventos de Google Meet con asistentes
• ❌ Cancela eventos - Elimina eventos que ya no necesitas
• 🔍 Busca eventos - Encuentra eventos dentro de rangos de fechas específicos

🤖 Ejemplos de integración con Claude

Pregúntale a Claude cosas como:

• "¿Qué reuniones tengo hoy?"
• "Programa una reunión de equipo para mañana a las 10 AM con el equipo de ingeniería"
• "Cancela mi reunión de las 3 PM del viernes"
• "¿Cómo se ve mi horario la próxima semana?"
• "Crea un Google Meet para nuestra revisión con el cliente el próximo martes"

🚀 Inicio rápido

Paso 1: Requisitos previos

• Python 3.8 o superior
• Una cuenta de Google con acceso a Calendar
• Cuenta de Nango para autenticación (maneja el OAuth de Google por ti)

Paso 2: Instalación

# Clone or download the MCP server files
git clone <your-repo-url>
cd google-calendar-mcp

# Install required packages
uv sync

Paso 3: Configurar variables de entorno

Crea un archivo .env en el directorio del proyecto:

# Copy the example file
cp .env.example .env

Edita .env con tus credenciales de Nango:

# Required Nango Configuration
NANGO_NANGO_BASE_URL=https://api.nango.dev
NANGO_NANGO_SECRET_KEY=your_nango_secret_key_here 
NANGO_CONNECTION_ID=your_connection_id_here
NANGO_INTEGRATION_ID=your_integration_id_here

🔧 ¿Necesitas ayuda con la configuración de Nango? ¡Consulta la Guía de configuración de Nango a continuación!

Paso 4: Configurar Claude Desktop

Añade esta configuración a los ajustes de Claude Desktop:

En macOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-calendar": {
      "command": "uvx",
      "args": ["git+https://github.com/Shameerpc5029/google-calendar-mcp.git"],
      "env": {
        "NANGO_NANGO_BASE_URL": "https://api.nango.dev",
        "NANGO_NANGO_SECRET_KEY": "your_nango_secret_key_here",
        "NANGO_CONNECTION_ID": "your_connection_id_here", 
        "NANGO_INTEGRATION_ID": "your_integration_id_here"
      }
    }
  }
}

Paso 5: ¡Pruébalo!

1. Reinicia Claude Desktop por completo
2. Inicia una nueva conversación con Claude
3. Pregúntale a Claude: "¿Qué reuniones tengo hoy?"

Si todo está configurado correctamente, ¡Claude podrá acceder a tu Google Calendar! 🎉

🛠️ Herramientas disponibles

Herramienta	Descripción	Ejemplo de uso
get_all_calendars	Lista todos tus calendarios de Google	"Muéstrame todos mis calendarios"
get_calendar_events	Obtén eventos de un calendario específico	"¿Qué hay en mi calendario de trabajo esta semana?"
create_meet_event	Crea un nuevo evento con Google Meet	"Programa una reunión de equipo para el viernes a las 2 PM"
cancel_calendar_event	Elimina/cancela un evento	"Cancela mi reunión de las 3 PM de hoy"
get_today_events	Obtén los eventos de hoy	"¿Cuál es mi horario de hoy?"
get_upcoming_events	Obtén los próximos eventos	"¿Qué tengo la próxima semana?"

🔧 Guía de configuración de Nango

Nango maneja el complejo flujo de OAuth de Google por ti. Así es como configurarlo:

1. Crea una cuenta de Nango

• Ve a Nango.dev y regístrate
• Crea un nuevo proyecto

2. Configura la integración de Google Calendar

• En tu panel de Nango, añade una nueva integración
• Elige "Google Calendar" como proveedor
• Sigue la guía de Nango para configurar las credenciales de OAuth de Google

3. Obtén tus credenciales

• NANGO_SECRET_KEY: Se encuentra en la configuración de tu proyecto de Nango
• NANGO_CONNECTION_ID: Se crea cuando un usuario conecta su cuenta de Google
• NANGO_INTEGRATION_ID: El ID de tu integración de Google Calendar

4. Prueba tu conexión

# Test that your environment is set up correctly
python -c "import os; print('✅ All env vars set!' if all([os.getenv('NANGO_CONNECTION_ID'), os.getenv('NANGO_INTEGRATION_ID'), os.getenv('NANGO_NANGO_SECRET_KEY')]) else '❌ Missing env vars')"

🧪 Probando tu configuración

Opción 1: Prueba con MCP Inspector

# Install the MCP inspector
npm install -g @modelcontextprotocol/inspector

# Test your server
npx @modelcontextprotocol/inspector python main.py

Opción 2: Prueba directa con Python

# Run the server directly to see if it starts without errors
python main.py

Opción 3: Prueba con Claude

Pregúntale a Claude: "¿Puedes verificar qué herramientas de calendario están disponibles?"

🔍 Solución de problemas

Problemas comunes

❌ "No se pudieron recuperar los calendarios"

• Verifica tus credenciales de Nango en .env
• Verifica tu conexión de Google Calendar en el panel de Nango
• Asegúrate de que la cuenta de Google tenga acceso al calendario

❌ "Se requiere la variable de entorno NANGO_CONNECTION_ID"

• Asegúrate de que tu archivo .env esté en el mismo directorio que el script de Python
• Verifica que todas las variables de entorno estén configuradas correctamente
• Reinicia Claude Desktop después de hacer cambios

❌ Claude no puede encontrar las herramientas de calendario

• Verifica que la ruta completa en tu configuración de Claude sea correcta
• Asegúrate de haber reiniciado Claude Desktop por completo
• Revisa los registros de Claude Desktop para ver mensajes de error

Obtener ayuda

1. Revisa los registros: Claude Desktop muestra los registros del servidor MCP en su consola de desarrollador
2. Prueba tu .env: Ejecuta python -c "from dotenv import load_dotenv; load_dotenv(); import os; print(os.environ.get('NANGO_CONNECTION_ID'))"
3. Verifica las rutas de archivo: Asegúrate de que todas las rutas en tu configuración de Claude sean rutas absolutas

📋 Ejemplo de uso con Claude

Una vez configurado, puedes tener conversaciones naturales con Claude sobre tu calendario:

Tú: "¿Cómo se ve mi horario hoy?"

Claude: Revisaré tu calendario para ver los eventos de hoy.

{
  "success": true,
  "events": [
    {
      "summary": "Team Standup",
      "start": "2024-01-15T09:00:00Z",
      "end": "2024-01-15T09:30:00Z"
    }
  ],
  "total_events": 1
}

Tienes 1 evento hoy: Reunión de equipo de 9:00 AM a 9:30 AM.

---

Tú: "Programa una reunión con un cliente para el próximo viernes a las 2 PM con john@company.com"

Claude: Crearé esa reunión para ti con un enlace de Google Meet.

{
  "success": true,
  "event": {
    "summary": "Client Meeting",
    "start": "2024-01-19T14:00:00Z",
    "attendees": [{"email": "john@company.com"}]
  }
}

✅ Se creó "Reunión con cliente" para el viernes 19 de enero a las 2:00 PM con john@company.com. El enlace de Google Meet se ha incluido automáticamente.

🔐 Seguridad y privacidad

• Tus credenciales: Se almacenan localmente en tu archivo .env - nunca se comparten
• Acceso a Google: Gestionado a través del flujo OAuth seguro de Nango
• Manejo de datos: Todos los datos del calendario permanecen entre tu cuenta de Google, Nango y Claude
• Sin almacenamiento de datos: Este servidor MCP no almacena ninguna de tus informaciones de calendario

🤝 Contribuciones

¿Encontraste un error o quieres añadir una función?

1. Haz un fork del repositorio
2. Crea una rama de características
3. Haz tus cambios
4. Prueba a fondo
5. Envía una solicitud de extracción (pull request)

📄 Licencia

Licencia MIT - ¡siéntete libre de usarlo en tus propios proyectos!

---

🎉 ¡Disfruta de tu nuevo asistente de calendario impulsado por IA!

Si te resultó útil, considera darle una estrella al repositorio y compartirlo con otras personas que puedan beneficiarse de la gestión de calendario con IA.