google_workspace_mcp MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

11 serviços em um servidor: Gmail, Drive, Calendar, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Apps Script
Camadas de ferramentas (core/extended/complete) para reduzir a lista de ferramentas em prompts mais baratos
OAuth 2.0 via suas próprias credenciais do Google Cloud — sem intermediário terceirizado
Suporta transportes MCP stdio + HTTP
Saídas transmissíveis para leituras longas de documentos/planilhas

Demo ao vivo

Como fica na prática

google-workspace.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-workspace": {
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-workspace",
      "command": "uvx",
      "args": [
        "google_workspace_mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "google-workspace": {
      "command": {
        "path": "uvx",
        "args": [
          "google_workspace_mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add google-workspace -- uvx google_workspace_mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: google_workspace_mcp

Como organizar sua caixa de entrada para zero com rótulos e rascunhos de IA

👤 Profissionais do conhecimento, executivos ⏱ ~20 min intermediate

Quando usar: Segunda-feira de manhã ou pós-férias quando sua caixa de entrada é uma zona de guerra.

Pré-requisitos

Projeto Google Cloud com API do Gmail ativada — console.cloud.google.com > APIs > Gmail API > Enable
Credenciais OAuth 2.0 Desktop — Credenciais > Criar cliente OAuth > Desktop. Configure GOOGLE_OAUTH_CLIENT_ID e _SECRET env vars

Fluxo

Recuperar a última semana de mensagens não lidas

Procurar no Gmail mensagens não lidas dos últimos 7 dias. Agrupar por categoria do remetente (team, external, vendor, newsletter).✓ Copiado

→ Contagens agrupadas + linhas de visualização
Rotular automaticamente + arquivar boletins informativos

Para o bucket de boletins informativos, rotule-os como 'newsletter' e arquive.✓ Copiado

→ Contagem arquivada, IDs de thread
Rascunhar respostas para os 5 principais threads reais

Para os 5 threads mais importantes (solicitação do cliente, bloqueador, decisão necessária), rascunhe uma resposta concisa. Não envie — apenas rascunhe.✓ Copiado

→ 5 rascunhos visíveis no Gmail

Resultado: Caixa de entrada com menos de 20, rascunhos prontos para revisar + enviar.

Armadilhas

IA envia respostas em vez de rascunhar — Sempre diga 'draft only' no prompt; desative send_gmail_message para sessões não confiáveis

Combine com: notion

Como se preparar para cada reunião amanhã a partir do seu calendário

👤 Qualquer pessoa com reuniões consecutivas ⏱ ~15 min beginner

Quando usar: Final do dia antes de um dia intenso.

Fluxo

Listar eventos de amanhã

Obtenha meus eventos de calendário para amanhã. Para cada um, mostre os participantes e o título da reunião.✓ Copiado

→ Linha do tempo de eventos
Para cada reunião, encontre documento vinculado e e-mails recentes

Para cada reunião com um link de agenda, abra o documento e resuma. Para cada participante, mostre a última thread de e-mail com ele.✓ Copiado

→ Resumo por reunião
Despejar em um documento

Crie um Doc 'Prep 2026-04-15' com uma seção por reunião.✓ Copiado

→ URL do Doc retornada

Resultado: Um único documento de preparação que você pode folhear enquanto toma café.

Armadilhas

E-mails dos participantes externos contêm PII — eles vão para seu provedor de LLM — Remova para apenas nomes nos prompts se você se importar

Combine com: notion

Como transformar uma Planilha Google em uma fonte de dados de leitura/escrita para agentes

👤 Pessoas de operações executando processos de negócios em Planilhas ⏱ ~15 min intermediate

Quando usar: Você não quer migrar para um banco de dados real ainda, mas quer que a IA responda perguntas + registre eventos.

Fluxo

Descrever o layout da planilha

Leia a aba 'Orders' na planilha 1AbC... — diga-me o esquema.✓ Copiado

→ Lista de colunas com tipos
Responder uma pergunta

Usando read_sheet_values, quantos pedidos em março foram superiores a $1000?✓ Copiado

→ Resposta numérica + células consultadas
Anexar uma linha

Anexe uma nova linha: data de hoje, customer=acme, amount=1200, status=pending.✓ Copiado

→ Índice da linha anexada

Resultado: Análise ad-hoc + registro sem sair do chat.

Armadilhas

Fórmulas recalculam na escrita e podem sobrescrever células que você se importa — Use append_table_rows, não range writes, ao adicionar dados

Combine com: filesystem

Como gerar um Google Doc a partir de um modelo markdown

👤 Qualquer pessoa gerando propostas, relatórios ou documentos de modelo ⏱ ~10 min beginner

Quando usar: Você quer saída rica de Docs (tabelas, cabeçalhos) sem aprender a API do Google.

Fluxo

Rascunho em markdown

Escreva uma proposta de cliente para ACME com base em [brief]. Saída como markdown.✓ Copiado

→ Rascunho Markdown
Converter em Doc

Crie um novo Google Doc intitulado 'ACME Proposal 2026-04' com esse conteúdo. Use create_doc e depois batch_update_doc para preservar a formatação.✓ Copiado

→ URL do Doc

Resultado: Um Doc corretamente formatado que você pode compartilhar.

Armadilhas

create_doc apenas aceita texto simples — formatação precisa de um batch_update de acompanhamento — Sempre use o fluxo de duas etapas para documentos ricos

Combinações

Combine com outros MCPs para 10× de alavancagem

google-workspace + notion

Espelhar documentos de preparação de reunião em Notion para visibilidade da equipe

Para cada reunião hoje, copie a agenda do Google Doc para uma nova página Notion em 'Notas de Reunião' com a data como título.✓ Copiado

google-workspace + filesystem

Exportar uma pasta do Drive para disco local como backup

Baixe cada arquivo na pasta do Drive 'Client Contracts 2025' para /backups/drive/contracts-2025/.✓ Copiado

google-workspace + github

Referenciar cruzadamente problemas do GitHub com standups de calendário

Antes de meu standup de 10am, liste os problemas abertos do GitHub atribuídos a mim e anexe o resumo à descrição do evento standup de hoje.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_gmail_messages	query: str, max_results?: int	Encontrar mensagens por remetente, assunto, data	1 chamada da API Gmail
draft_gmail_message	to, subject, body, thread_id?	Prefira rascunho em vez de enviar para workflows de IA	1 chamada de API
send_gmail_message	to, subject, body	Apenas quando o usuário explicitamente pedir para enviar	1 chamada de API (irreversível)
get_events	calendar_id?, time_min, time_max	Extrair eventos em uma janela	1 chamada da API Calendar
manage_event	action, event_id?, summary?, attendees?, time?	Criar/atualizar/excluir eventos	1 chamada de API
read_sheet_values	spreadsheet_id, range	Ler um intervalo de células	1 chamada da API Sheets
append_table_rows	spreadsheet_id, table_id, rows	Anexação segura sem sobrescrever fórmulas	1 chamada da API Sheets
create_doc	title, content?	Iniciar um novo doc	1 chamada da API Docs
batch_update_doc	doc_id, requests[]	Aplicar formatação após create_doc	1 chamada da API Docs (em lote)
search_drive_files	query, max_results?	Localizar um arquivo por nome/proprietário	1 chamada da API Drive

Custo e limites

O que custa rodar

Cota de API: Gmail: 250 unidades de cota/usuário/seg. Sheets: 300 leituras/min/usuário. Drive: 1000 consultas/100s/usuário.
Tokens por chamada: Lista de ferramentas na camada 'complete' é enorme (~100 ferramentas); use a camada 'core' para manter barato
Monetário: Gratuito com uma conta do Google
Dica: Execute com --tool-tier core e alterne para extended apenas quando realmente precisar de Slides/Forms/Script.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Conceda apenas os escopos para os serviços que você realmente usa (por exemplo, gmail.readonly, calendar.readonly)

Armazenamento de credenciais: GOOGLE_OAUTH_CLIENT_ID/_SECRET em env; tokens de atualização persistidos em disco

Saída de dados: Seus conteúdos de doc/e-mail passam pelo servidor MCP para seu provedor de LLM escolhido

Nunca conceda: gmail.send se você não precisar enviar drive (full) se drive.file for suficiente escopos de administrador

OAUTHLIB_INSECURE_TRANSPORT=1 é apenas para desenvolvimento de localhost — nunca defina em uma instância hospedada.
Clientes OAuth para Desktop não podem ser usados para implementações da web de produção; use um cliente Web lá.

Solução de problemas

Erros comuns e correções

invalid_grant / token expirou ou foi revogado

Exclua o arquivo de token em cache e execute novamente o fluxo de autenticação.

Verificar: ls ~/.config/google_workspace_mcp/tokens

403 permissão insuficiente

Re-consinta com o escopo necessário — o token armazenado ainda não o tem.

API não ativada

Ative a API específica (por exemplo, Docs API) no Google Cloud Console para seu projeto.

Cota excedida para o usuário

Gmail e Sheets têm limites por minuto. Leia em lote; volte com retry exponencial.

Alternativas

google_workspace_mcp vs. outros

Alternativa	Quando usar	Troca
MCP oficial do Gmail (remoto Anthropic)	Você quer OAuth hospedado Anthropic com configuração zero	Apenas Gmail; sem Drive/Docs/Sheets
zapier MCP	Você já paga por Zapier e quer zero config	Custa dinheiro por chamada; latência mais alta

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills