remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides full integration with Google Calendar API for creating, retrieving, updating, and deleting events

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

Instalación mediante herrería

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.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Tools

Integración de Google Calendar en Cursor IDE. Este servidor permite que los asistentes de IA gestionen eventos de Google Calendar mediante interacciones de lenguaje natural.