Skip to main content
Glama

Google Calendar MCP Server

by am2rican5

Servidor MCP de Google Calendar

Un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con Google Calendar, creado con TypeScript.

Características

  • Integración perfecta de Google Calendar con la autenticación OAuth 2.0
  • Almacenamiento persistente de tokens para autenticación automática
  • Enumere y administre calendarios con operaciones de eventos integrales
  • Crear, leer, actualizar y eliminar eventos del calendario
  • Obtener eventos del calendario entre fechas específicas
  • Opción de transporte de eventos enviados por el servidor (SSE) para actualizaciones en tiempo real
  • Integración sencilla con Claude y otros asistentes de IA compatibles con MCP

Instalación

npm install -g mcp-google-calendar

O ejecutar directamente con:

npx -y mcp-google-calendar

Prerrequisitos

  1. Node.js (v16 o superior)
  2. Cuenta de Google Cloud Platform
  3. API de Google Calendar habilitada
  4. Credenciales de OAuth 2.0

Configuración

1. Configuración de Google Cloud

  1. Ir a la consola de Google Cloud
  2. Crea un nuevo proyecto o selecciona uno existente
  3. Habilitar la API de Google Calendar:
    • Vaya a "API y servicios" > "Biblioteca".
    • Buscar "API de Google Calendar"
    • Haga clic en "Habilitar"
  4. Configurar la pantalla de consentimiento de OAuth:
    • Vaya a "API y servicios" > "Pantalla de consentimiento de OAuth".
    • Elija el tipo de usuario "Externo" (o "Interno" para Google Workspace)
    • Complete la información requerida:
      • Nombre de la aplicación: mcp-calendar
      • Correo electrónico de soporte al usuario: (su correo electrónico)
      • Información de contacto del desarrollador: (su correo electrónico)
    • Añadir ámbitos:
    • Completar la configuración
  5. Crear credenciales OAuth:
    • Vaya a "Credenciales"
    • Haga clic en "Crear credenciales" > "ID de cliente OAuth".
    • Seleccione "Aplicación de escritorio" como tipo de aplicación
    • Asígnele un nombre (por ejemplo, "Cliente de escritorio de calendario MCP")
    • Descargue el archivo JSON y guárdelo como credentials.json en el directorio de su proyecto

2. Configuración del entorno

Crea un archivo .env en la raíz de tu proyecto:

# Server configuration PORT=3420 # Google Calendar API configuration CREDENTIALS_PATH=./credentials.json

Uso

Iniciando el servidor

Comience con WebSockets estándar:

npx -y mcp-google-calendar

Comience con eventos enviados por el servidor (SSE):

npx -y mcp-google-calendar --sse

Con Claude Desktop

Agregue esto a su claude_desktop_config.json :

{ "mcpServers": { "mcp-google-calendar": { "command": "npx", "args": ["-y", "mcp-google-calendar"], "env": { "CREDENTIALS_PATH": "/path/to/your/credentials.json" } } } }

Proceso de autenticación

La primera vez que ejecute el servidor:

  1. Se abrirá automáticamente una ventana del navegador.
  2. Inicia sesión con tu cuenta de Google
  3. Otorgar los permisos de calendario solicitados
  4. El token de autenticación se guarda en token.json

En lanzamientos posteriores:

  • El servidor utiliza automáticamente el token guardado
  • No se requiere interacción del navegador a menos que el token expire

Herramientas disponibles

HerramientaDescripción
list_calendarsObtenga todos los calendarios disponibles
list_calendar_eventsRecuperar eventos entre fechas específicas
create_calendar_eventAñade un nuevo evento a tu calendario
get_calendar_eventObtener detalles de un evento específico
edit_calendar_eventModificar un evento de calendario existente
delete_calendar_eventEliminar un evento de tu calendario

Desarrollo

Clonar y configurar el proyecto:

git clone https://github.com/am2rican5/mcp-google-calendar.git cd mcp-google-calendar npm install

Construir el proyecto:

npm run build

Ejecutar en modo de desarrollo:

npm start

Consideraciones de seguridad

⚠️ Advertencia de seguridad importante ⚠️

  • credentials.json y token.json contienen información de autenticación confidencial
  • Nunca envíe estos archivos al control de versiones ni los comparta públicamente.
  • Cada usuario debe crear sus propias credenciales OAuth
  • Si sospecha que las credenciales están comprometidas, revoquelas inmediatamente en Google Cloud Console
  • El token otorga acceso a sus datos de Google Calendar

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

  1. Bifurcar el repositorio
  2. Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
  3. Confirme sus cambios ( git commit -m 'Add some amazing feature' )
  4. Empujar a la rama ( git push origin feature/amazing-feature )
  5. Abrir una solicitud de extracción
-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integra Google Calendar con asistentes de IA a través del Protocolo de Contexto de Modelo, lo que permite a los usuarios ver y administrar eventos del calendario a través de la interacción en lenguaje natural.

  1. Características
    1. Instalación
      1. Prerrequisitos
        1. Configuración
          1. 1. Configuración de Google Cloud
          2. 2. Configuración del entorno
        2. Uso
          1. Iniciando el servidor
          2. Con Claude Desktop
          3. Proceso de autenticación
        3. Herramientas disponibles
          1. Desarrollo
            1. Consideraciones de seguridad
              1. Licencia
                1. Contribuyendo

                  Related MCP Servers

                  • -
                    security
                    A
                    license
                    -
                    quality
                    Enables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.
                    Last updated -
                    9
                    2
                    TypeScript
                    MIT License
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server that enables AI assistants to interact with Gmail services, supporting email operations, draft management, and calendar functionality through Google API integration.
                    Last updated -
                    49
                    1
                    TypeScript
                  • -
                    security
                    F
                    license
                    -
                    quality
                    Model Context Protocol server that provides seamless access to Google Calendar API with asynchronous operation support, enabling efficient calendar management through a standardized interface.
                    Last updated -
                    1
                    Python
                    • Apple
                    • Linux
                  • -
                    security
                    A
                    license
                    -
                    quality
                    Enables AI assistants to manage Google Calendar through natural language interactions with features like creating, updating, and deleting events, searching calendars, and supporting natural language date/time inputs.
                    Last updated -
                    6
                    1
                    JavaScript
                    MIT License
                    • Apple
                    • Linux

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/am2rican5/mcp-google-calendar'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server