Proyecto de integración de Google Calendar

insignia de herrería

Este proyecto proporciona integración con la API de Google Calendar para administrar e interactuar con eventos del calendario mediante programación.

Prerrequisitos

Python 3.8 o superior
Cuenta de Google Cloud Platform
API de Google Calendar habilitada
Credenciales OAuth 2.0 configuradas

Related MCP server: Google Calendar AutoAuth MCP Server

Instrucciones de configuración

Instalación mediante herrería

Para instalar automáticamente el proyecto de integración de Google Calendar para Claude Desktop a través de Smithery :

npx -y smithery install @Avik-creator/googlecalendarMCP --client claude

Instalación manual

Clonar el repositorio
git clone https://github.com/Avik-creator/googlecalendarMCP cd googlecalendarMCP
Configurar entorno virtual
python -m venv venv source venv/bin/activate # On Windows, use `venv\Scripts\activate`
Instalar dependencias
pip install -r requirements.txt
Configuración de Google Cloud Platform
a. Accede a la consola de Google Cloud. b. Crea un proyecto nuevo o selecciona uno existente. c. Habilita la API de Google Calendar. d. Crea las credenciales de OAuth 2.0.
- Vaya a API y servicios > Credenciales
- Haga clic en "Crear credenciales" > "ID de cliente OAuth".
- Seleccione "Aplicación de escritorio"
- Descargar el archivo JSON de credenciales
- Renombralo credentials.json y colócalo en la raíz del proyecto
Variables de entorno
Cree un archivo .env en la raíz del proyecto con las siguientes variables:
GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json CALENDAR_ID=your_calendar_id@group.calendar.google.com

Uso

Autenticación por primera vez
python auth.py
Se abrirá una ventana del navegador para la autenticación OAuth. Siga las instrucciones para autorizar la aplicación.
Ejecutar la aplicación
python main.py

Características

Crear, leer, actualizar y eliminar eventos del calendario
Configurar eventos recurrentes
Gestionar los asistentes al evento
Gestionar notificaciones y recordatorios de eventos

Estructura del proyecto

googlecalendarMCP/ ├── auth.py # Authentication handling ├── main.py # Main application entry point ├── requirements.txt # Project dependencies ├── .env # Environment variables ├── credentials.json # Google OAuth credentials └── token.json # Generated OAuth token

Dependencias

El proyecto utiliza las siguientes dependencias principales:

google-auth-oauthlib
autenticación de Google httplib2
cliente de google-api-python
python-dotenv

Configuración implementada:

{ "mcpServers": { "google_calendar_mcp": { "command": "npx", "args": [ "mcp-remote", "https://mcp-google-calendar.avikm744.workers.dev/sse" ] } } }

Notas de seguridad

Nunca envíe sus archivos credentials.json , token.json o .env al control de versiones
Mantenga sus credenciales OAuth seguras
Rote regularmente sus credenciales y tokens