Google Services MCP

go-google-mcp

Servidor unificado del Protocolo de Contexto de Modelo (MCP) para Google Workspace.

go-google-mcp es una herramienta potente, segura y extensible basada en Go que permite a los agentes de IA (como Claude Desktop, Cursor o Gemini CLI) interactuar directamente con tus servicios de Google a través de una interfaz estandarizada.

🚀 Características

Interactúa con Google Workspace usando lenguaje natural a través de estos servicios integrados:

• 📂 Google Drive: Búsqueda potente, lectura de contenido de texto, creación de archivos/carpetas, actualización de contenido, mover, compartir y enviar a la papelera.
• 📧 Gmail: Buscar/listar hilos, leer conversaciones completas, crear borradores, mover a la papelera y enviar correos electrónicos.
• 📅 Google Calendar: Listar próximos eventos, crear nuevas reuniones (con asistentes) y eliminar eventos.
• 📊 Google Sheets: Crear hojas de cálculo, leer rangos, añadir filas y actualizar celdas específicas.
• 📄 Google Docs: Crear nuevos documentos y leer el texto completo del documento.
• 👥 Google People: Listar contactos y crear nuevas conexiones.
• ✅ Google Tasks: Listar listas de tareas y tareas, crear, actualizar y eliminar tareas (con filtrado opcional por estado/fecha).

🛠 Instalación

Asegúrate de tener Go instalado (versión 1.24 o posterior recomendada).

go install github.com/matheusbuniotto/go-google-mcp/cmd/go-google-mcp@latest

🔐 Autenticación

Esta herramienta admite tanto OAuth 2.0 de Usuario (mejor para uso personal/CLI) como Cuentas de Servicio (mejor para uso en servidor/automatizado).

Opción 1: OAuth de Usuario (Recomendado)

1. Crear Credenciales: Ve a la Consola de Google Cloud, habilita las APIs necesarias (Drive, Gmail, etc.) y crea un cliente OAuth de Aplicación de Escritorio.
2. Descargar JSON: Guarda el archivo de secretos del cliente como client_secrets.json.
3. Inicio de Sesión Único:

   go-google-mcp auth login --secrets path/to/client_secrets.json
   

   Esto guarda tu token de forma segura en ~/.go-google-mcp/.

Opción 2: Cuenta de Servicio

1. Descarga tu clave JSON de la Cuenta de Servicio.
2. Ejecuta con la bandera -creds:

   go-google-mcp -creds path/to/service-account.json
   

🤖 Uso con Agentes de IA

Claude Desktop / Cursor

Añade lo siguiente a tu claude_desktop_config.json (o a la configuración MCP de tu IDE):

{
  "mcpServers": {
    "google-workspace": {
      "command": "go-google-mcp",
      "args": []
    }
  }
}

Gemini CLI

gemini mcp add google-workspace $(which go-google-mcp)

🛠 Desarrollo

git clone https://github.com/matheusbuniotto/go-google-mcp.git
cd go-google-mcp
go build ./cmd/go-google-mcp

📜 Licencia

Licencia MIT. Consulta LICENSE para más detalles.