Servidor MCP de calendario
Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración de Google Calendar en Claude Desktop. Este servidor permite a los asistentes de IA gestionar eventos de Google Calendar mediante interacciones de lenguaje natural.
Características
- Crea eventos de calendario con título, hora, descripción y ubicación
- Recuperar detalles del evento por ID de evento
- Actualizar eventos existentes (título, hora, descripción, ubicación)
- Eliminar eventos
- Enumerar eventos dentro de un rango de tiempo específico
- Integración completa con la API de Google Calendar
- Autenticación segura OAuth2
Instalación
Para instalar la integración de Google Calendar para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @gongrzhe/server-calendar-mcp --client claude
Instalación manual
npm install @gongrzhe/server-calendar-mcp
Configuración
- Crea un proyecto de Google Cloud y obtén las credenciales:a. Crear un proyecto de Google Cloud:
- Ir a la consola de Google Cloud
- Crea un nuevo proyecto o selecciona uno existente
- Habilite la API de Google Calendar para su proyecto
b. Crear credenciales OAuth 2.0:
- Vaya a "API y servicios" > "Credenciales".
- Haga clic en "Crear credenciales" > "ID de cliente OAuth".
- Seleccione "Aplicación de escritorio" como tipo de aplicación
- Dale un nombre y haz clic en "Crear"
- Obtendrás tu
GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET
c. Obtener token de actualización:
- Ir al patio de juegos de OAuth 2.0
- Haga clic en el ícono de engranaje (Configuración) en la parte superior derecha
- Marque "Usar sus propias credenciales de OAuth"
- Ingrese su ID de cliente OAuth y su secreto de cliente
- En el panel izquierdo, busque "Calendar API v3" y seleccione " https://www.googleapis.com/auth/calendar "
- Haga clic en "Autorizar API" y complete el flujo de OAuth
- Haga clic en "Intercambiar código de autorización por tokens".
- Copia el "Token de actualización": este es tu
GOOGLE_REFRESH_TOKEN
- Configurar en Claude Desktop:
{
"calendar": {
"command": "npx",
"args": [
"@gongrzhe/server-calendar-mcp"
],
"env": {
"GOOGLE_CLIENT_ID": "your_client_id_here",
"GOOGLE_CLIENT_SECRET": "your_client_secret_here",
"GOOGLE_REFRESH_TOKEN": "your_refresh_token_here"
}
}
}
Ejemplos de uso
El servidor proporciona varias herramientas que se pueden utilizar a través de Claude Desktop:
Crear evento
{
"summary": "Team Meeting",
"start": {
"dateTime": "2024-01-20T10:00:00Z"
},
"end": {
"dateTime": "2024-01-20T11:00:00Z"
},
"description": "Weekly team sync",
"location": "Conference Room A"
}
Lista de eventos
{
"timeMin": "2024-01-01T00:00:00Z",
"timeMax": "2024-12-31T23:59:59Z",
"maxResults": 10,
"orderBy": "startTime"
}
Evento de actualización
{
"eventId": "event123",
"summary": "Updated Meeting Title",
"start": {
"dateTime": "2024-01-20T11:00:00Z"
},
"end": {
"dateTime": "2024-01-20T12:00:00Z"
}
}
Eliminar evento
{
"eventId": "event123"
}
Notas de seguridad
- Mantenga seguras sus credenciales de API de Google
- Gire periódicamente sus tokens de actualización
- Almacenar información confidencial en la configuración de Claude Desktop
- Nunca comparta ni comprometa sus credenciales con el control de versiones
- El token de actualización da acceso a tu Calendario de Google. Trátalo como una contraseña.
Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
Licencia
Este proyecto está licenciado bajo la licencia ISC.
Autor
Gongrzhe
Apoyo
Si encuentra algún problema o tiene preguntas, envíe un problema en el repositorio de GitHub.