Sheets MCP

Google Sheets para fluxos de trabalho de agentes no Claude Code e Claude Desktop: escreva saída de scripts, APIs e arquivos em planilhas, combine planilhas, trabalhe em várias contas do Google. Verificações de fórmulas, desfazer, pré-visualização ao vivo.

GitHub
35

Documentação

Sheets MCP

A ferramenta poderosa para Google Sheets no Claude. Um servidor MCP gratuito e de código aberto que conecta suas planilhas a tudo que o Claude Desktop e o Claude Code podem fazer: puxar dados de APIs e arquivos para uma planilha, criar novas planilhas a partir de outras, mantê-las atualizadas em um cronograma e trabalhar com várias contas do Google. Fórmulas, formatação, gráficos e tabelas dinâmicas incluídos, com desfazer e verificação de erros de fórmula em cada gravação. Ele roda no seu computador e fala diretamente com o Google.

Veja todos os recursos e assista à demonstração em sheetsmcp.io →

Claude adds a profit column, totals, currency formatting and a chart while a live preview of the sheet updates in the chat

Gratuito e de código aberto · Roda no seu computador · Acesso ao Google apenas para planilhas · Claude Desktop e Claude Code

Se o Sheets MCP economizar seu tempo, uma ⭐ no GitHub ajuda outras pessoas a encontrá-lo.

Sheets MCP ou a integração integrada do Google Sheets do Claude?

O Claude agora tem sua própria integração com Google Sheets em planos pagos. Ambos permitem que o Claude edite suas planilhas; eles atendem a diferentes tarefas.

Sheets MCPIntegração integrada do Claude
Melhor paraTrabalho que vai além de uma planilha: APIs, arquivos, outras planilhas, cronogramasEdições rápidas na planilha que você tem aberta
PreçoGratuito e funciona no plano gratuito do Claude no Claude DesktopPlanos pagos do Claude
Onde funcionaClaude Desktop (abas Chat e Code) e Claude CodeChat do Claude e uma barra lateral dentro do Google Sheets
ConfiguraçãoExtensão com um clique ou um comando. O Google mostra uma tela de "aplicativo não verificado" no login por enquantoIntegrado
Para onde seus dados vãoDo seu computador direto para o Google, com acesso apenas a planilhas. Sem outros servidoresAtravés do conector hospedado da Anthropic
CódigoCódigo aberto (MIT): leia, altere, execute o seu próprioProduto da Anthropic
ExtrasVárias contas do Google, desfazer, verificação de erros de fórmula, pré-visualização ao vivo no chatBarra lateral no Sheets, aprovações de edição, Python para limpeza de dados

Em resumo: está em um plano pago e só quer que o Claude edite a planilha à sua frente? A integração integrada é a mais simples. Quer que o Claude una suas planilhas com todo o resto, gratuitamente? Use o Sheets MCP. Você pode usar ambos.

Instalação

Claude Desktop (mais fácil, sem configuração)

  1. Instale o Claude Desktop e faça login.
  2. Baixe Sheets MCP para Claude Desktop (um arquivo .mcpb; veja o que há de novo).
  3. Clique duas vezes no arquivo e depois em Instalar no Claude Desktop.

Novo no Claude Desktop? Siga o guia de configuração passo a passo.

A extensão funciona nas abas Chat e Code. Para tarefas longas e de várias etapas, a aba Code é a opção mais confiável: ela executa tudo no seu computador.

Claude Code

Requer Node.js 18 ou mais recente. Execute:

claude mcp add --scope user google-sheets -- npx -y @sheetsmcp/server

Depois, inicie uma nova sessão do Claude Code.

Login

Na primeira vez que o Claude usar o Google Sheets, uma página de login do Google abre no seu navegador:

  1. Escolha sua conta do Google.
  2. O Google mostra "O Google não verificou este aplicativo". Clique em Avançado e depois em Ir para Sheets MCP.
  3. Clique em Continuar para permitir o acesso às suas planilhas.

Para usar mais de uma conta do Google, peça ao Claude para "fazer login em outra conta do Google". Quando você cola um link de planilha, o Sheets MCP usa qualquer uma das suas contas que possa abri-la.

Para abrir o login do Google em um navegador específico sem alterar o padrão, adicione "browser": "Google Chrome" (ou outro nome de aplicativo) a ~/.sheets-mcp/settings.json.

Se o Google Workspace da sua empresa bloquear o login, o administrador do Workspace pode permitir o Sheets MCP em Console do administrador → Segurança → Controles de API.

Experimente pedir

No Claude Desktop, clique em + e escolha Começar com Google Sheets para um tour rápido. Quando mais de uma conta do Google estiver conectada, o Claude pergunta qual conta usar antes de criar uma planilha, ou quando uma planilha pode ser aberta por mais de uma das suas contas.

  • "Resuma esta planilha: "
  • "Adicione uma coluna Lucro que subtraia Custo de Receita e formate como moeda"
  • "Crie um gráfico de gastos por mês nesta planilha: "
  • "Congele a linha do cabeçalho, deixe em negrito e ajuste automaticamente as larguras das colunas"
  • "Resuma a receita por região e produto em uma tabela dinâmica"
  • "Mude esse gráfico para um gráfico de linhas e mova-o para perto da tabela"
  • "Crie uma nova planilha chamada Planejador de Viagem"
  • "Abra minha planilha de orçamento" (funciona para planilhas que você já usou com o Sheets MCP)
  • "Puxe os pagamentos do Stripe da semana passada para a aba Caixa" (Claude Code)
  • "Combine as planilhas de vendas Leste e Oeste em um novo resumo do Q3 com um gráfico"
  • "Copie a previsão do Q4 da minha conta de trabalho para a planilha do quadro na minha conta pessoal"
  • "Desfazer isso"

Mais exemplos de solicitações e tudo que o Sheets MCP pode fazer →

Trabalhados recentemente

O Sheets MCP mantém uma lista das planilhas que você usou com ele, no seu computador. No Claude Desktop, comece a falar sobre suas planilhas ("vamos trabalhar no meu orçamento") ou peça "mostre minhas planilhas recentes", e uma lista pesquisável abre no chat: fixe as que você mais usa, abra-as no Google Sheets ou marque várias (mesmo de contas diferentes do Google) e envie-as ao Claude com o que você quer fazer. No Claude Code, digite /mcp__google-sheets__recent_sheets ou pergunte "quais planilhas eu usei?".

Pré-visualização ao vivo

No Claude Desktop, o Claude abre uma pré-visualização ao vivo da sua planilha no chat enquanto trabalha. Você vê cada intervalo que ele lê e cada alteração que faz em tempo real, incluindo gráficos, e a pré-visualização se recolhe quando o Claude termina. Abrir no Sheets salta para as mesmas células no Google Sheets.

Após atualizar o Sheets MCP, saia e reabra o Claude Desktop para que ele carregue a nova pré-visualização.

A pré-visualização é desenhada no aplicativo de desktop do Claude. Se você seguir uma sessão pelo celular com o Controle Remoto, o Sheets MCP continua funcionando no seu computador e a pré-visualização estará lá quando você voltar.

Veja em ação em sheetsmcp.io →

Privacidade

O Sheets MCP roda no seu computador. Seu login do Google é armazenado apenas no seu computador (em ~/.sheets-mcp), e as solicitações vão direto do seu computador para o Google. Não há servidor do Sheets MCP no meio. Ele pede ao Google acesso apenas às suas planilhas, não ao resto do seu Drive. Para encontrar planilhas por nome e a lista de Trabalhados recentemente, ele mantém uma lista das planilhas que você usou com ele em ~/.sheets-mcp/recent.json no seu computador; exclua esse arquivo para limpar a lista. Os dados de planilha que o Claude lê fazem parte da sua conversa com o Claude. Veja a política de privacidade.

Para desconectar, peça ao Claude para "sair do Google Sheets" ou remova o Sheets MCP em myaccount.google.com/permissions.

Linha de comando (opcional)

npx @sheetsmcp/server auth                      # sign in to a Google account
npx @sheetsmcp/server accounts                  # list signed-in accounts
npx @sheetsmcp/server accounts default <email>  # choose the default account
npx @sheetsmcp/server accounts remove <email>   # sign out an account

Saiba mais