Google Services MCP

go-google-mcp

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

go-google-mcp é uma ferramenta poderosa, segura e extensível baseada em Go que permite que agentes de IA (como Claude Desktop, Cursor ou Gemini CLI) interajam diretamente com seus serviços do Google por meio de uma interface padronizada.

🚀 Recursos

Interaja com o Google Workspace usando linguagem natural por meio destes serviços integrados:

• 📂 Google Drive: Pesquisa poderosa, leitura de conteúdo de texto, criação de arquivos/pastas, atualização de conteúdo, mover, compartilhar e enviar para a lixeira.
• 📧 Gmail: Pesquisar/listar conversas, ler conversas completas, criar rascunhos, mover para a lixeira e enviar e-mails.
• 📅 Google Calendar: Listar eventos futuros, criar novas reuniões (com participantes) e excluir eventos.
• 📊 Google Sheets: Criar planilhas, ler intervalos, anexar linhas e atualizar células específicas.
• 📄 Google Docs: Criar novos documentos e ler o texto completo do documento.
• 👥 Google People: Listar contatos e criar novas conexões.
• ✅ Google Tasks: Listar listas de tarefas e tarefas, criar, atualizar e excluir tarefas (com filtro opcional por status/vencimento).

🛠 Instalação

Certifique-se de ter o Go instalado (versão 1.24 ou posterior recomendada).

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

🔐 Autenticação

Esta ferramenta suporta tanto OAuth 2.0 de usuário (melhor para uso pessoal/CLI) quanto contas de serviço (melhor para uso em servidor/automatizado).

Opção 1: OAuth de usuário (Recomendado)

1. Criar credenciais: Acesse o Google Cloud Console, ative as APIs necessárias (Drive, Gmail, etc.) e crie um cliente OAuth de aplicativo para desktop.
2. Baixar JSON: Salve o arquivo de segredos do cliente como client_secrets.json.
3. Login único:

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

   Isso salva seu token com segurança em ~/.go-google-mcp/.

Opção 2: Conta de serviço

1. Baixe a chave JSON da sua conta de serviço.
2. Execute com a flag -creds:

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

🤖 Uso com Agentes de IA

Claude Desktop / Cursor

Adicione o seguinte ao seu claude_desktop_config.json (ou às configurações de MCP da sua IDE):

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

Gemini CLI

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

🛠 Desenvolvimento

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

📜 Licença

Licença MIT. Consulte LICENSE para obter detalhes.