Google Sheets MCP

Google Sheets MCP

Um conector Model Context Protocol (MCP) para Google Sheets que permite que agentes de IA interajam diretamente com planilhas.

Demonstração

https://github.com/user-attachments/assets/cc4729d9-4e6e-437b-848b-6da9a09418c3

Configuração

1. Clone este repositório:

git clone https://github.com/mkummer225/google-sheets-mcp
cd google-sheets-mcp

2. Instale as dependências: npm install

3. Compile: npm run build

4. Crie credenciais OAuth no Google Cloud Platform:

   • Crie um novo projeto no Google Cloud Console
   • Ative a Google Sheets API
   • Configure a tela de consentimento OAuth
   • Crie credenciais de ID do cliente OAuth (aplicativo de desktop) com um URI de redirecionamento apropriado (ex: http://localhost:3000/oauth2callback)
   • Baixe as credenciais e salve como gcp-oauth.keys.json no subdiretório dist

5. Inicie o servidor MCP (você será automaticamente solicitado a autenticar/reautenticar sua conta do Google quando necessário): npm run start

Uso

Configuração de exemplo:

{
    "mcpServers": {
    "google-sheets-mcp": {
      "command": "node",
      "args": [
        "/{path_to_dir}/google-sheets-mcp/dist/index.js"
      ]
    }
  }
}

Então você deve ser capaz de simplesmente especificar seu spreadsheetId ou pedir ao seu agente para criar um novo para você.

Ações Disponíveis

Ação	Descrição
refresh_auth	Reautenticar sua Conta do Google quando as credenciais expirarem
list_sheets	Listar todas as planilhas/abas em uma Planilha do Google
create_sheet	Criar uma nova planilha/aba em uma Planilha do Google
create_spreadsheet	Criar uma nova Planilha do Google
read_all_from_sheet	Ler todos os dados de uma planilha especificada
read_headings	Ler os cabeçalhos das colunas de uma planilha
read_rows	Ler linhas específicas de uma planilha
read_columns	Ler colunas específicas de uma planilha
edit_cell	Editar uma única célula em uma planilha
edit_row	Editar uma linha inteira em uma planilha
edit_column	Editar uma coluna inteira em uma planilha
insert_row	Inserir uma nova linha em uma posição especificada
insert_column	Inserir uma nova coluna em uma posição especificada
rename_sheet	Renomear uma planilha/aba em uma planilha
rename_doc	Renomear uma Planilha do Google

Licença

MIT