Multi Google MCP

Servidor MCP Google multi-contas para Claude Code — Gmail, Drive, Calendar, Sheets, Docs, Contacts, Search Console. 83 ferramentas com alternância de múltiplas contas via OAuth2.

GitHub
12
Experimente este MCPPatrocinado

Documentação

mcp-google-multi

O servidor MCP local mais completo para Google Workspace: Gmail, Drive, Calendar, Sheets, Docs, Slides, Forms, Contacts, Tasks, Chat, Meet, Analytics (GA4), Search Console, Classroom, Vault, Admin e muito mais — todos os métodos de API acessíveis via OAuth como ferramentas, em várias contas Google ao mesmo tempo, a partir do Claude Code ou de qualquer cliente MCP.

npm

  • 🧰 Exaustivo — 940 ferramentas em 29 serviços, agora incluindo Google Analytics (GA4), além de uma saída de emergência para qualquer outra coisa → COVERAGE.md
  • 🔑 Multi-contas — use quantas contas Google quiser por alias, ou envie uma única chamada para todas elas
  • 🔒 Privado por design — seu próprio aplicativo OAuth, tokens criptografados em repouso (AES-256-GCM), gravações negadas por padrão, sem telemetria, sem medição — ele fala apenas com o Google
  • 🌐 Local ou remoto — roda localmente via stdio, ou auto-hospedado via HTTP com seu próprio servidor OAuth 2.1 integrado (login /mcp do Claude Code e o conector claude.ai, sem UI personalizada). Docker Compose com pull-and-up e HTTPS automático opcional → configuração remota
  • ✉️ Feito para trabalho real — envie e leia e-mails em Markdown com anexos e respostas em uma única chamada, um assistente de configuração interativo com verificação automática doctor, e perfis de escopo por conta → tour de recursos

Configuração rápida

Novato nisso tudo? Está escrito para alguém que acabou de instalar o Claude Code e nunca criou uma chave de API. Copie e cole cada etapa; ele diz o que você verá. (Já é técnico? A Referência de configuração é a versão resumida.)

  1. Instale. Baixe o Node.js (o botão verde "LTS", versão 22 ou mais recente) e execute:

    npm install -g mcp-google-multi

    Usuário do Claude Desktop? Você pode pular o npm completamente: baixe o pacote mcp-google-multi.mcpb da última versão, clique duas vezes nele (ou arraste-o para Claude Desktop → Configurações → Extensões) e preencha os valores do passo 2 quando solicitado.

  2. Crie sua chave Google (a única parte manual, alguns minutos, porque o Google não tem como automatizar isso). Siga o passo a passo de Configuração do Google Cloud, ou apenas peça ao Claude Code: "me guie na criação de um cliente OAuth Desktop do Google para mcp-google-multi." Você termina com dois valores: um Client ID e um Client Secret. É gratuito e privado para você.

  3. Coloque-os em um arquivo. Na pasta de onde você vai executar, crie um arquivo chamado .env e cole isto, preenchendo seus 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

    Nenhuma chave de criptografia para criar: o servidor gera e armazena uma para você.

  4. Entre. Um navegador abre; escolha sua conta e clique em Permitir:

    mcp-google-multi auth --account me

  5. Adicione ao Claude Code e reinicie o Claude Code:

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

Travou em algum ponto? Execute mcp-google-multi doctor. Ele inspeciona cada parte e imprime a correção exata para qualquer problema (login ausente, uma API do Google que você ainda precisa ativar, etc.). Quando ele mostrar tudo verde, é só conversar com o Claude: "resuma meus e-mails não lidos."

Tem mais de uma conta Google? Adicione-as juntas, como GOOGLE_ACCOUNTS=me:you@gmail.com,work:you@company.com, e execute o passo 4 uma vez para cada apelido.

Em um servidor ou pelo claude.ai? Caminho avançado: Configuração remota / HTTP. Vindo da v5? Guia de migração para v6.

Aprofunde-se: Referência de configuração · O que está coberto · Tour de recursos · Configuração remota / HTTP · Segredos em um cofre · Métricas de uso local · Migrando para v6 · Política de segurança · Roadmap

Mantenedor e créditos

Construído e mantido por Abdelbaki Berkati — berkati.xyz · @bakissation. Leia o estudo de caso →

O desenvolvimento é financiado pela IdeaCrafters (@IdeaCraftersHQ) — o estúdio que paga para este OSS existir.

Agradecimentos aos contribuidores @obatried, @trevor-commits e @mjreddy. O projeto é liderado pelo mantenedor (roadmap em Milestones; relatórios de bugs são bem-vindos, PRs de recursos mediante acordo prévio — veja CONTRIBUTING.md). O feedback molda o roadmap: abra uma issue com bugs, pontos problemáticos ou o que você gostaria que ele fizesse. Relatórios de segurança vão para SECURITY.md, nunca para uma issue pública.

Licença

MIT