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

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

Configuración

1. Configuración de Google Cloud

Ir a la consola de Google Cloud
Crea un nuevo proyecto o selecciona uno existente
Habilitar la API de Google Calendar:
- Vaya a "API y servicios" > "Biblioteca".
- Buscar "API de Google Calendar"
- Haga clic en "Habilitar"
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:
  - Haga clic en "Agregar o quitar ámbitos"
  - Busque y seleccione " https://www.googleapis.com/auth/calendar.events "
  - Añade tu correo electrónico como usuario de prueba
- Completar la configuración
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:

Se abrirá automáticamente una ventana del navegador.
Inicia sesión con tu cuenta de Google
Otorgar los permisos de calendario solicitados
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

Herramienta	Descripción
`list_calendars`	Obtenga todos los calendarios disponibles
`list_calendar_events`	Recuperar eventos entre fechas específicas
`create_calendar_event`	Añade un nuevo evento a tu calendario
`get_calendar_event`	Obtener detalles de un evento específico
`edit_calendar_event`	Modificar un evento de calendario existente
`delete_calendar_event`	Eliminar 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.

Bifurcar el repositorio
Crea tu rama de funciones ( git checkout -b feature/amazing-feature )
Confirme sus cambios ( git commit -m 'Add some amazing feature' )
Empujar a la rama ( git push origin feature/amazing-feature )
Abrir una solicitud de extracción

Google Calendar MCP Server

Integrations