Proyecto de integración de Google Calendar

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

1. Clonar el repositorio

   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP

2. Configurar entorno virtual

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Instalar dependencias

   pip install -r requirements.txt

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

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

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

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

Contribuyendo

1. Bifurcar el repositorio

2. Crear una rama de características

3. Confirme sus cambios

4. Empujar hacia la rama

5. Crear una solicitud de extracción

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.