Google Workspace MCP服务器

mcp-google-workspace

MCP server pro Google Workspace (Gmail, Drive, Sheets) s automatickým OAuth flow a multi-user autentizací.

Funkce

• Gmail: query, read, reply, draft, send, archive, star, trash - s automatickým podpisem
• Google Drive: search, read, upload, create folders, delete
• Google Sheets: read, write, append, clear, add/delete sheets
• Google Calendar: list/create/patch/delete událostí, výpis a hledání místností (scope calendar.events od 0.3.2; uživatel přihlášený dřív se musí přihlásit znovu, jinak nástroje calendar_* vracejí 403 insufficientPermissions)
• Auto OAuth: při prvním použití se otevře prohlížeč pro Google přihlášení
• Multi-user: každý uživatel se přihlásí svým účtem (Cloud Run remote)
• Reply fix: správně zpracovává diakritiku v hlavičkách emailů

Quick Start (lokální)

Přidejte do .mcp.json:

{
  "mcpServers": {
    "google-workspace": {
      "command": "mcp-google-workspace",
      "env": {
        "GOOGLE_WORKSPACE_CLIENT_SECRET": "..."
      }
    }
  }
}

Server spouští MCP klient, ne vy, takže proměnná patří sem do env - export v shellu se k němu nemusí dostat.

"command": "mcp-google-workspace" počítá s tím, že server je nainstalovaný v PATH. Při vývoji z checkoutu (uv sync) leží spustitelný soubor v .venv, takže uveďte celou cestu, nebo použijte "command": "uv" s "args": ["run", "--project", "/cesta/k/mcp-google-workspace", "mcp-google-workspace"].

Nejdřív nastavte GOOGLE_WORKSPACE_CLIENT_SECRET (viz Konfigurace). Bez ní přihlášení skončí hned výjimkou - Google client secret vyžaduje i při PKCE.

Při prvním použití se pak otevře prohlížeč pro Google přihlášení. Token se uloží do ~/.config/mcp-google/credentials.json.

Lokální vývoj a testy

git clone https://github.com/Sensio-cz/mcp-google-workspace.git
cd mcp-google-workspace
uv sync                 # nebo: pip install -e .

uv run --with pytest --with cryptography pytest tests/ -q

Client secret pro vývoj najdete v Google Cloud Console u klienta „Sensio MCP" (projekt mzdy-487615). Nikam ho nezapisujte v repu - do 22. 9. 2026 stál jako výchozí hodnota v config.py a tenhle repozitář je veřejný.

Merge do master je nasazení na produkci. Cloud Build trigger v regionu europe-west1 po každém pushi do master sestaví a nasadí novou revizi. Podrobnosti a kontrola v CLAUDE.md.

Cloud Run (remote)

MCP server běží na Cloud Run a je dostupný přes:

https://mcp-google-workspace.sensio.cz/mcp

claude.ai Connector

1. Otevřete claude.ai - Settings - Connectors
2. Klikněte Add custom connector
3. Zadejte:
   • Name: MCP Google Workspace Sensio
   • URL: https://mcp-google-workspace.sensio.cz/mcp
4. Klikněte Add - otevře se Google přihlášení
5. Přihlaste se firemním účtem (@sensio.cz) a klikněte Povolit
6. Hotovo - Gmail, Drive a Sheets tools jsou dostupné

Gmail Tools

Drive Tools

Sheets Tools

Konfigurace

Pro lokální běh je povinná jedna proměnná:

Volitelné:

Release Status

License

MIT - Sensio.cz s.r.o.