Multi Google MCP

Servidor MCP de Google multicuenta para Claude Code: Gmail, Drive, Calendar, Sheets, Docs, Contacts, Search Console. 83 herramientas con cambio de cuenta múltiple mediante OAuth2.

Documentación

mcp-google-multi

El servidor MCP de Google Workspace local más completo: Gmail, Drive, Calendar, Sheets, Docs, Slides, Forms, Contacts, Tasks, Chat, Meet, Analytics (GA4), Search Console, Classroom, Vault, Admin y más — cada método de API accesible por OAuth como herramienta, en múltiples cuentas de Google a la vez, desde Claude Code o cualquier cliente MCP.

npm

  • 🧰 Exhaustivo — 940 herramientas en 29 servicios, ahora incluyendo Google Analytics (GA4), + una vía de escape para cualquier otra cosa → COVERAGE.md
  • 🔑 Multi-cuenta — gestiona cualquier número de cuentas de Google por alias, o envía una llamada a todas ellas a la vez
  • 🔒 Privado por diseño — tu propia aplicación OAuth, tokens cifrados en reposo (AES-256-GCM), escrituras denegadas por defecto, sin telemetría, sin medición — solo habla con Google
  • 🌐 Local o remoto — se ejecuta localmente sobre stdio, o auto-alojado sobre HTTP con su propio servidor OAuth 2.1 integrado (el inicio de sesión /mcp de Claude Code y el conector de claude.ai, sin interfaz personalizada). Docker Compose listo para usar con HTTPS automático opcional → configuración remota
  • ✉️ Hecho para trabajo real — envía y lee correos en Markdown con adjuntos y respuestas en una sola llamada, un asistente de configuración interactivo con autocomprobación doctor, y perfiles de alcance por cuenta → recorrido de funciones

Configuración rápida

¿Nuevo en todo esto? Está escrito para alguien que acaba de instalar Claude Code y nunca ha creado una clave API. Copia y pega cada paso; te dice lo que verás. (¿Ya eres técnico? La referencia de configuración es la versión concisa).

  1. Instálalo. Obtén Node.js (el botón verde "LTS", versión 22 o superior), luego ejecuta:

    npm install -g mcp-google-multi
    

    ¿Usuario de Claude Desktop? Puedes omitir npm por completo: descarga el paquete mcp-google-multi.mcpb desde la última versión, haz doble clic (o arrástralo a Claude Desktop → Configuración → Extensiones), y completa los valores del paso 2 cuando se te solicite.

  2. Crea tu clave de Google (la única parte manual, unos minutos, porque Google no permite automatizarlo). Sigue la configuración de Google Cloud paso a paso, o simplemente pídele a Claude Code: "guíame para crear un cliente OAuth de escritorio de Google para mcp-google-multi." Terminarás con dos valores: un ID de cliente y un Secreto de cliente. Es gratuito y privado para ti.

  3. Ponlos en un archivo. En la carpeta desde la que ejecutarás, crea un archivo llamado .env y pega esto, completando tus valores:

    GOOGLE_CLIENT_ID=paste-your-client-id
    GOOGLE_CLIENT_SECRET=paste-your-client-secret
    # any short nickname, then your Gmail address:
    GOOGLE_ACCOUNTS=me:you@gmail.com
    

    No necesitas crear una clave de cifrado: el servidor genera y almacena una por ti.

  4. Inicia sesión. Se abre un navegador; elige tu cuenta y haz clic en Permitir:

    mcp-google-multi auth --account me
    
  5. Agrégalo a Claude Code y reinicia Claude Code:

    claude mcp add google-multi -s user -- npx -y mcp-google-multi
    

¿Atascado en algún punto? Ejecuta mcp-google-multi doctor. Inspecciona cada parte e imprime la solución exacta para cualquier problema (una sesión faltante, una API de Google que aún necesitas activar, etc.). Una vez que todo esté en verde, solo habla con Claude: "resume mis correos no leídos."

¿Tienes más de una cuenta de Google? Agréguelas juntas, como GOOGLE_ACCOUNTS=me:you@gmail.com,work:you@company.com, y ejecuta el paso 4 una vez por apodo.

¿En un servidor o desde claude.ai? Ruta avanzada: Configuración remota / HTTP. ¿Vienes de v5? Guía de migración a v6.

Profundiza: Referencia de configuración · Qué está cubierto · Recorrido de funciones · Configuración remota / HTTP · Secretos en una bóveda · Métricas de uso local · Migración a v6 · Política de seguridad · Hoja de ruta

Mantenedor y créditos

Construido y mantenido por Abdelbaki Berkati — berkati.xyz · @bakissation. Lee el caso de estudio →

El desarrollo está financiado por IdeaCrafters (@IdeaCraftersHQ) — el estudio que paga por la existencia de este OSS.

Gracias a los colaboradores @obatried, @trevor-commits y @mjreddy. El proyecto está liderado por el mantenedor (hoja de ruta en Milestones; informes de errores bienvenidos, PRs de funciones con acuerdo previo — ver CONTRIBUTING.md). Los comentarios dan forma a la hoja de ruta: abre un issue con errores, puntos débiles o lo que te gustaría que hiciera. Los informes de seguridad van a SECURITY.md, nunca a un issue público.

Licencia

MIT