local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Enables interaction with Google Calendar, allowing users to create events, list upcoming events, and analyze their schedule. Provides access to calendar event data including titles, times, descriptions, and attendees.
Leverages Google Cloud authentication and APIs to access Google Calendar data, requiring a Google Cloud Project with Calendar API enabled and OAuth 2.0 Client credentials.
Servidor MCP de Google Calendar
Interactúe con su Google Calendar a través de Claude Desktop utilizando el Protocolo de contexto de modelo (MCP).
Este es un servidor MCP basado en TypeScript que implementa la integración con Google Calendar. Demuestra los conceptos básicos de MCP y proporciona:
- Gestión de eventos del calendario mediante URI de MCP
- Herramientas para crear y modificar eventos
- Indicaciones para generar información del calendario
Características
Recursos
- Acceda a eventos del calendario a través de URI de MCP
- Cada evento tiene título, hora, descripción y asistentes.
- Datos de eventos estructurados con tipos MIME adecuados
Herramientas
create_event
- Crea nuevos eventos de calendario- Toma el título, la hora y otros detalles del evento como parámetros.
- Interactúa directamente con la API de Google Calendar
list_events
- Ver los próximos eventos del calendario- [Agrega otras herramientas que hayas implementado]
Indicaciones
analyze_schedule
: genera información sobre tu calendario- Incluye próximos eventos como recursos integrados
- Devuelve una solicitud estructurada para el análisis de LLM
- [Agrega otras indicaciones que hayas implementado]
Prerrequisitos
- Node.js (v14 o superior)
- Un proyecto de Google Cloud con la API de calendario habilitada
- Credenciales de cliente OAuth 2.0
Desarrollo
Instale devbox siguiendo las instrucciones en devbox.sh
Inicializar devbox en el directorio del proyecto:
Inicie el shell de devbox:
Instalar dependencias:
Construir el servidor:
Para desarrollo con reconstrucción automática:
Instalación
Para utilizar con Claude Desktop, agregue la configuración del servidor:
En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
En Windows: %APPDATA%/Claude/claude_desktop_config.json
Configuración por primera vez
- Configurar las credenciales de Google Cloud:
- Ir a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona uno existente
- Habilitar la API de Google Calendar
- Crear credenciales OAuth 2.0 (tipo de aplicación de escritorio)
- Descargar el archivo JSON del secreto del cliente
- Renombralo a
.client_secret.json
y colócalo en la raíz del proyecto.
- Autenticación inicial:
- Cuando se ejecuta el servidor por primera vez, proporcionará una URL de autenticación
- Visita la URL en tu navegador
- Conceder los permisos solicitados
- Copia el código de autorización proporcionado
- Pegue el código nuevamente en el indicador CLI
Depuración
Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP , disponible como script de paquete:
El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.
This server cannot be installed
Permite la interacción con Google Calendar a través de Claude Desktop utilizando el Protocolo de Contexto de Modelo, habilitando la gestión de eventos del calendario y el análisis de la programación.