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

O ejecutar directamente con:

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:

     • 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

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:

Uso

Iniciando el servidor

Comience con WebSockets estándar:

Comience con eventos enviados por el servidor (SSE):

Con Claude Desktop

Agregue esto a su claude_desktop_config.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

Desarrollo

Clonar y configurar el proyecto:

Construir el proyecto:

Ejecutar en modo de desarrollo:

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