Google Sheets MCP Server

K čemu slouží “Google Sheets” MCP Server?

Google Sheets MCP (Model Context Protocol) Server je nástroj založený na TypeScriptu, který umožňuje AI asistentům bezpečně komunikovat s Google Sheets pomocí jasně definovaných, typovaných nástrojů. Funguje jako most mezi AI agenty a Google Sheets/Drive API a umožňuje robustní automatizaci i workflow pro manipulaci s daty. Server podporuje autentizaci jak přes OAuth2, tak přes Service Account, což jej činí flexibilním pro různé bezpečnostní požadavky. Jeho hlavní úlohou je umožnit vývojářům a AI workflow provádět úkoly, jako je vytváření tabulek, čtení a zápis dat do buněk, správa listů a záložek, nebo sdílení dokumentů – to vše programaticky a bezpečně. Tato integrace usnadňuje operace typu databázových dotazů, týmovou editaci i automatizaci workflow přímo v Google Sheets a zvyšuje tak produktivitu i AI-driven vývoj.

Seznam promptů

V repozitáři nejsou zdokumentovány žádné explicitní šablony promptů.

Seznam zdrojů

V repozitáři nejsou zdokumentovány žádné explicitní zdroje.

Seznam nástrojů

• create
  Vytvoří novou tabulku a volitelně ji přesune do zadané složky na Disku.
• listSheets
  Vypíše všechny záložky listů v dané tabulce.
• renameSheet
  Přejmenuje existující záložku listu.
• createSheet
  Přidá do tabulky nový list (záložku).
• spreadsheetInfo
  Načte metadata (název, ID listů, vlastnosti mřížky) k tabulce.
• listSpreadsheets
  Vypíše všechny tabulky ve vaší nastavené složce na Disku nebo na Mém disku.
• shareSpreadsheet
  Sdílí tabulku s uživateli (čtenář/komentátor/editor) a posílá notifikace.
• sheetData
  Čte hodnoty buněk z listu a rozsahu (nebo z celého listu).
• updateCells
  Zapíše 2D pole hodnot do rozsahu ve stylu A1.
• batchUpdate
  Provede více aktualizací rozsahů v jednom požadavku.
• addRows / addColumns
  Vloží řádky nebo sloupce na určený index.
• copySheet
  Zkopíruje záložku listu mezi tabulkami s možností přejmenování.

Příklady použití tohoto MCP serveru

• Automatizované vytváření a správa tabulek
  Plynule vytvářejte nové tabulky, přidávejte nebo přejmenovávejte listy/záložky a organizujte soubory v Google Drive, vše v rámci automatizovaných workflow.
• Extrakce a aktualizace dat
  Čtěte a zapisujte velké datové sady z/do Google Sheets, ideální pro ETL pipeline, reporting a automatizaci dashboardů.
• Spolupráce a sdílení
  Programaticky sdílejte tabulky s různými uživateli a nastavujte oprávnění, což usnadňuje týmovou spolupráci a automatizovaná upozornění.
• Hromadné operace a manipulace s daty
  Provádějte hromadné aktualizace, vkládejte více řádků/sloupců a efektivně upravujte velké tabulky, což šetří čas při opakovaných úlohách.
• Duplikace a organizace listů
  Kopírujte listy mezi tabulkami pro šablonování, zálohování nebo organizační workflow, což podporuje škálovatelné operace napříč týmy.

Jak jej nastavit

Windsurf

1. Ujistěte se, že máte nainstalovaný Bun (v1.0+) a nastavené Google Cloud přihlašovací údaje (OAuth2 nebo Service Account).
2. Naklonujte repozitář a nainstalujte závislosti:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. Nastavte proměnné prostředí podle níže uvedeného příkladu.
4. Do konfiguračního souboru Windsurf přidejte MCP server pomocí JSON úryvku.
5. Uložte konfiguraci a restartujte Windsurf.

Příklad JSON konfigurace:

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

Zabezpečení API klíčů pomocí proměnných prostředí:

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

Claude

1. Nainstalujte požadavky a naklonujte repozitář.
2. Nastavte Google Cloud autentizaci a proměnné prostředí.
3. Najděte a upravte konfigurační soubor MCP pro Claude.
4. Přidejte Google Sheets MCP server pomocí konfiguračního úryvku.
5. Restartujte Claude a ověřte spojení.

Příklad JSON konfigurace:

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

Cursor

1. Ujistěte se, že máte nainstalovaný Bun a nastavené přihlašovací údaje.
2. Stáhněte a nastavte repozitář.
3. Upravte konfigurační soubor MCP pro Cursor.
4. Přidejte záznam pro Google Sheets MCP server.
5. Uložte změny a restartujte Cursor pro aktivaci serveru.

Příklad JSON konfigurace:

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

Cline

1. Nainstalujte Bun a nastavte přihlašovací údaje projektu Google Cloud.
2. Naklonujte repozitář a nainstalujte všechny potřebné závislosti.
3. Otevřete a upravte konfigurační soubor MCP serveru pro Cline.
4. Zaregistrujte Google Sheets MCP server pomocí JSON formátu.
5. Restartujte Cline pro použití nové konfigurace.

Příklad JSON konfigurace:

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

Zabezpečení API klíčů pomocí proměnných prostředí:

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

Jak používat tento MCP ve flow

Použití MCP ve FlowHunt

Pro integraci MCP serverů do svého workflow ve FlowHunt přidejte do toku komponentu MCP a propojte ji se svým AI agentem:

Klikněte na komponentu MCP pro otevření konfiguračního panelu. V sekci systémové konfigurace MCP vložte údaje svého MCP serveru v tomto JSON formátu:

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

Po konfiguraci může AI agent využívat tento MCP jako nástroj se všemi jeho funkcemi a možnostmi. Nezapomeňte změnit “google-sheets” na skutečný název vašeho MCP serveru a upravit URL na vaši vlastní adresu MCP serveru.

Přehled

Náš názor

Tento MCP server je dobře zdokumentovaný pro nastavení a nabízí robustní sadu nástrojů pro automatizaci Google Sheets. Postrádá však explicitní dokumentaci promptů a zdrojů a není zmíněna podpora sampling/roots. Díky pokrytí nástrojů a jasnému zabezpečení je cenným pomocníkem pro automatizaci tabulek, avšak vylepšení by přineslo doplnění dokumentace k promptům/zdrojům a upřesnění podpory sampling/roots.

MCP skóre