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

Related MCP server: Gmail AutoAuth MCP Server

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

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

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

3. Configurar en Claude Desktop:

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

Soporte de Docker

Si prefieres usar Docker:

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

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

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

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

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