Google Calendar MCP Server

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

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.

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Features
    1. Resources
    2. Tools
    3. Prompts
  2. Prerequisites
    1. Development
      1. Installation
        1. First-Time Setup
          1. Debugging
        ID: kczvcz87zx