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]

Related MCP server: Google Calendar MCP Server

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

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

Inicializar devbox en el directorio del proyecto:

devbox init

Inicie el shell de devbox:

devbox shell

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

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

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

Configuración por primera vez

1. 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.

2. 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:

npm run inspector

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