-
security-
license-
qualityGoogle Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.
Last updated -
0
5
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:
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/oauth2callbacka las URI de redireccionamiento autorizadasDescargue 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 authb. 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 authEl proceso de autenticación:
Busque
gcp-oauth.keys.jsonen 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/oauth2callbacka 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.jsonesté 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
weboinstalledPara 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
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.
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.
Related MCP Servers
- -security-license-qualityServer for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.Last updated -2,386724MIT License
- -security-license-qualityAn integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.Last updated -7
- -security-license-qualityA Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.Last updated -2453MIT License