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:
- 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:
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.
- 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