Servidor MCP do Google Sheets

O que faz o Servidor MCP do “Google Sheets”?

O Servidor MCP do Google Sheets (Model Context Protocol) é uma ferramenta baseada em TypeScript que permite que assistentes de IA interajam de maneira segura com o Google Sheets por meio de ferramentas tipadas e bem definidas. Atuando como uma ponte entre agentes de IA e a API do Google Sheets/Drive, ele possibilita automação robusta e fluxos de manipulação de dados. O servidor suporta autenticação tanto via OAuth2 quanto Conta de Serviço, tornando-se flexível para diferentes requisitos de segurança. Seu principal papel é capacitar desenvolvedores e fluxos de trabalho de IA a realizar tarefas como criar planilhas, ler e escrever dados em células, gerenciar sheets e abas, e compartilhar documentos—tudo de forma programática e segura. Esta integração simplifica operações como consultas estilo banco de dados, edição colaborativa e automação de workflows diretamente no Google Sheets, aumentando a produtividade e os processos de desenvolvimento orientados por IA.

Lista de Prompts

Nenhum template de prompt explícito está documentado no repositório.

Lista de Recursos

Nenhum recurso explícito está documentado no repositório.

Lista de Ferramentas

• create
  Cria uma nova planilha e, opcionalmente, move para uma pasta específica do Drive.
• listSheets
  Lista todas as abas de uma determinada planilha.
• renameSheet
  Renomeia uma aba existente.
• createSheet
  Adiciona uma nova aba em uma planilha.
• spreadsheetInfo
  Busca metadados (título, IDs das abas, propriedades de grade) de uma planilha.
• listSpreadsheets
  Lista todas as planilhas em sua pasta configurada do Drive ou no Meu Drive.
• shareSpreadsheet
  Compartilha uma planilha com usuários (leitor/comentarista/editor) e envia notificações.
• sheetData
  Lê valores de células de uma aba e intervalo (ou da aba inteira).
• updateCells
  Escreve um array 2D de valores em um intervalo no formato A1.
• batchUpdate
  Aplica múltiplas atualizações de intervalo em uma única requisição.
• addRows / addColumns
  Insere linhas ou colunas em um índice específico.
• copySheet
  Copia uma aba entre planilhas, com opção de renomear.

Casos de Uso deste Servidor MCP

• Criação e Gestão Automatizada de Planilhas
  Crie novas planilhas, adicione ou renomeie abas e organize arquivos no Google Drive de forma totalmente automatizada.
• Extração e Atualização de Dados
  Leia e escreva grandes conjuntos de dados do/para o Google Sheets, ideal para pipelines ETL, relatórios e automação de dashboards.
• Acesso Colaborativo e Compartilhamento
  Compartilhe planilhas programaticamente com diferentes usuários e defina permissões, facilitando colaboração em equipe e notificações automáticas.
• Operações em Massa e Manipulação de Dados
  Realize atualizações em lote, insira múltiplas linhas/colunas e aplique mudanças em grandes planilhas com eficiência, economizando tempo em tarefas repetitivas.
• Duplicação e Organização de Abas
  Copie abas entre planilhas para templates, backup ou fluxos de organização, apoiando operações escaláveis em equipes.

Como configurar

Windsurf

1. Certifique-se de ter o Bun (v1.0+) instalado e configure as credenciais do Google Cloud (OAuth2 ou Conta de Serviço).
2. Clone o repositório e instale as dependências:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. Configure as variáveis de ambiente conforme mostrado abaixo.
4. No arquivo de configuração do Windsurf, adicione o servidor MCP com um snippet JSON.
5. Salve sua configuração e reinicie o Windsurf.

Exemplo de configuração JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Protegendo chaves de API com variáveis de ambiente:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Claude

1. Instale os pré-requisitos e clone o repositório.
2. Configure a autenticação do Google Cloud e as variáveis de ambiente.
3. Localize e edite o arquivo de configuração MCP do Claude.
4. Adicione o servidor MCP do Google Sheets com o snippet de configuração.
5. Reinicie o Claude e verifique a conexão.

Exemplo de configuração JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cursor

1. Certifique-se de que o Bun está instalado e as credenciais estão configuradas.
2. Baixe e configure o repositório.
3. Edite o arquivo de configuração MCP do Cursor.
4. Inclua a entrada do servidor MCP do Google Sheets.
5. Salve as alterações e reinicie o Cursor para ativar o servidor.

Exemplo de configuração JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cline

1. Instale o Bun e configure as credenciais do seu projeto Google Cloud.
2. Clone o repositório e instale todas as dependências necessárias.
3. Acesse e edite a configuração do servidor MCP do Cline.
4. Registre o servidor MCP do Google Sheets usando o formato JSON.
5. Reinicie o Cline para aplicar a configuração.

Exemplo de configuração JSON:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Protegendo chaves de API usando variáveis de ambiente:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP no seu fluxo do FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração do sistema MCP, insira os detalhes do seu servidor MCP utilizando este formato JSON:

{
  "google-sheets": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá utilizar este MCP como ferramenta com acesso a todas as suas funções e capacidades. Lembre-se de alterar “google-sheets” para o nome real do seu servidor MCP e substituir a URL pela do seu servidor MCP.

Visão Geral

Nossa opinião

Este servidor MCP é bem documentado quanto à configuração e oferece um conjunto robusto de ferramentas para automação no Google Sheets. No entanto, não possui templates explícitos de prompt MCP e recursos, e não há menção a suporte para sampling ou roots. Sua ampla cobertura de ferramentas e orientações claras de segurança tornam-no valioso para automação de planilhas, mas poderia ser melhorado com documentação de prompts/recursos e esclarecimento sobre sampling/roots.

Pontuação MCP