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
- 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:
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:
- 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:
Construir el proyecto:
Ejecutar en modo de desarrollo:
Consideraciones de seguridad
⚠️ Advertencia de seguridad importante ⚠️
credentials.json
ytoken.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
This server cannot be installed
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.
Related MCP Servers
- -securityAlicense-qualityEnables comprehensive calendar management with capabilities to create, list, update, and delete events through a Model Context Protocol server integrated with Google Calendar.Last updated -92TypeScriptMIT License
- -securityFlicense-qualityA 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 -491TypeScript
- -securityFlicense-qualityModel 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 -1Python
- -securityAlicense-qualityEnables 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 -61JavaScriptMIT License