local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables AI assistants to manage Google Calendar events, including creating, retrieving, updating, and deleting events, as well as listing events within a specified time range.
Used for authentication via Google Cloud Project and OAuth 2.0 credentials to access the Google Calendar API.

Servidor MCP de autenticación automática de calendario

Un servidor de Protocolo de Contexto de Modelo (MCP) para la integración de Google Calendar en Cluade Desktop con compatibilidad con autenticación automática. 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
Flujo de autenticación OAuth2 simple con inicio automático del navegador
Compatibilidad con credenciales de aplicaciones web y de escritorio
Almacenamiento global de credenciales para mayor comodidad

Instalación y autenticación

Instalación mediante herrería

Para instalar automáticamente Calendar AutoAuth Server para Claude Desktop a través de Smithery :

npx -y @smithery/cli install @gongrzhe/server-calendar-autoauth-mcp --client claude

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".
- Elija "Aplicación de escritorio" o "Aplicación web" como tipo de aplicación
- Dale un nombre y haz clic en "Crear"
- Para la aplicación web, agregue http://localhost:3000/oauth2callback a las URI de redireccionamiento autorizadas
- Descargue el archivo JSON de las claves OAuth de su cliente
- Cambie el nombre del archivo de clave a gcp-oauth.keys.json
Ejecutar autenticación:Puedes autenticarte de dos maneras:a. Autenticación global (recomendada):
# First time: Place gcp-oauth.keys.json in your home directory's .calendar-mcp folder mkdir -p ~/.calendar-mcp mv gcp-oauth.keys.json ~/.calendar-mcp/ # Run authentication from anywhere npx @gongrzhe/server-calendar-autoauth-mcp auth
b. Autenticación local:
# Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @gongrzhe/server-calendar-autoauth-mcp auth
El proceso de autenticación:
- Busque gcp-oauth.keys.json en el directorio actual o ~/.calendar-mcp/
- Si se encuentra en el directorio actual, cópielo a ~/.calendar-mcp/
- Abra su navegador predeterminado para la autenticación de Google
- Guardar las credenciales como ~/.calendar-mcp/credentials.json
Nota :
- Después de una autenticación exitosa, las credenciales se almacenan globalmente en ~/.calendar-mcp/ y se pueden usar desde cualquier directorio.
- Se admiten credenciales tanto de aplicaciones de escritorio como de aplicaciones web
- Para las credenciales de la aplicación web, asegúrese de agregar http://localhost:3000/oauth2callback a sus URI de redireccionamiento autorizados
Configurar en Claude Desktop:

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-calendar-autoauth-mcp"
      ]
    }
  }
}

Soporte de Docker

Si prefieres usar Docker:

Autenticación:

docker run -i --rm \
  --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \
  -v mcp-calendar:/calendar-server \
  -e CALENDAR_OAUTH_PATH=/gcp-oauth.keys.json \
  -e "CALENDAR_CREDENTIALS_PATH=/calendar-server/credentials.json" \
  -p 3000:3000 \
  mcp/calendar auth

Uso:

{
  "mcpServers": {
    "calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-calendar:/calendar-server",
        "-e",
        "CALENDAR_CREDENTIALS_PATH=/calendar-server/credentials.json",
        "mcp/calendar"
      ]
    }
  }
}

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

Las credenciales de OAuth se almacenan de forma segura en su entorno local ( ~/.calendar-mcp/ )
El servidor utiliza acceso sin conexión para mantener una autenticación persistente
Nunca comparta ni comprometa sus credenciales con el control de versiones
Revise y revoque periódicamente el acceso no utilizado en la configuración de su cuenta de Google
Las credenciales se almacenan globalmente, pero solo el usuario actual puede acceder a ellas.

Solución de problemas

Claves OAuth no encontradas
- Asegúrese de que gcp-oauth.keys.json esté en su directorio actual o en ~/.calendar-mcp/
- Comprobar permisos de archivos
Formato de credenciales no válidas
- Asegúrese de que su archivo de claves OAuth contenga credenciales web o installed
- Para aplicaciones web, verifique que la URI de redireccionamiento esté configurada correctamente
Puerto ya en uso
- Si el puerto 3000 ya está en uso, libérelo antes de ejecutar la autenticación
- Puedes encontrar y detener el proceso usando ese puerto

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

A

license - permissive license

-

quality - not tested

Servidor para la integración de Google Calendar en Cluade Desktop con autenticación automática. Este servidor permite que los asistentes de IA gestionen eventos de Google Calendar mediante interacciones con lenguaje natural.

Calendar AutoAuth MCP Server