Google Calendar

Se integra con Google Calendar para gestionar eventos y generar información del calendario.

GitHub
2
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Google Calendar

Interactúa con tu Google Calendar a través de Claude Desktop usando el Protocolo de Contexto de Modelo (MCP).

Este es un servidor MCP basado en TypeScript que implementa la integración con Google Calendar. Demuestra conceptos centrales de MCP mientras proporciona:

  • Gestión de eventos de calendario a través de URIs de MCP
  • Herramientas para crear y modificar eventos
  • Prompts para generar información sobre el calendario

Características

Recursos

  • Accede a eventos de calendario a través de URIs de MCP
  • Cada evento tiene título, hora, descripción y asistentes
  • Datos de eventos estructurados con tipos mime adecuados

Herramientas

  • create_event - Crear nuevos eventos de calendario
    • Toma título, hora y otros detalles del evento como parámetros
    • Interactúa directamente con la API de Google Calendar
  • list_events - Ver próximos eventos de calendario
  • [Agrega otras herramientas que hayas implementado]

Prompts

  • analyze_schedule - Generar información sobre tu calendario
    • Incluye próximos eventos como recursos integrados
    • Devuelve un prompt estructurado para análisis por LLM
  • [Agrega otros prompts que hayas implementado]

Requisitos previos

  • Node.js (v14 o superior)
  • Un proyecto de Google Cloud con la API de Calendar habilitada
  • Credenciales de cliente OAuth 2.0

Desarrollo

Instala devbox siguiendo las instrucciones en devbox.sh

curl -fsSL https://get.jetpack.io/devbox | bash

Inicializa devbox en el directorio del proyecto:

devbox init

Inicia el shell de devbox:

devbox shell

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Para desarrollo con recompilación automática:

npm run watch

Instalación

Para usar con Claude Desktop, agrega la configuración del servidor:

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

{
  "mcpServers": {
    "Google Calendar": {
      "command": "/path/to/Google Calendar/build/index.js"
    }
  }
}

Configuración inicial

  1. Configura las credenciales de Google Cloud:

    • Ve a Consola de Google Cloud
    • Crea un nuevo proyecto o selecciona uno existente
    • Habilita la API de Google Calendar
    • Crea credenciales OAuth 2.0 (tipo aplicación de escritorio)
    • Descarga el archivo JSON del secreto del cliente
    • Renómbralo a .client_secret.json y colócalo en la raíz del proyecto

  2. Autenticación inicial:

    • Al ejecutar el servidor por primera vez, se proporcionará una URL de autenticación
    • Visita la URL en tu navegador
    • Otorga los permisos solicitados
    • Copia el código de autorización proporcionado
    • Pega el código en el prompt de la CLI

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.