gws-mcp-server

MCP-Server, der Google Workspace CLI (gws)-Operationen als Model Context Protocol-Tools bereitstellt.

Warum?

Die gws CLI hatte einen integrierten MCP-Server, der in v0.8.0 entfernt wurde, da er 200-400 Tools bereitstellte — was zu einer Überlastung des Kontextfensters in MCP-Clients führte. Dieser Server verfolgt einen kuratierten Ansatz: Sie wählen aus, welche Google-Dienste bereitgestellt werden sollen, und nur ein fokussierter Satz an wertvollen, eng gefassten Operationen wird als Tool registriert.

Voraussetzungen

• Node.js 18+

• gws CLI installiert und authentifiziert (npm install -g @googleworkspace/cli && gws auth login)

Schnellstart

# Install
npm install -g gws-mcp-server

# Or run from source
git clone https://github.com/conorbronsdon/gws-mcp-server.git
cd gws-mcp-server
npm install && npm run build

Konfiguration

Claude Code (.mcp.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar,docs,gmail"
      ]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar"
      ]
    }
  }
}

Optionen

Verfügbare Dienste & Tools

drive (8 Tools)

• drive_files_list — Dateien suchen und auflisten

• drive_files_get — Dateimetadaten abrufen

• drive_files_create — Dateien erstellen (mit optionalem Upload)

• drive_files_copy — Dateien kopieren (nützlich für Formatkonvertierungen)

• drive_files_update — Dateimetadaten/-inhalte aktualisieren

• drive_files_delete — Dateien löschen

• drive_files_export — Google Workspace-Dateien (Doc, Sheet, Slide) in andere Formate exportieren

• drive_permissions_create — Dateien freigeben

sheets (4 Tools)

• sheets_get — Tabellen-Metadaten abrufen

• sheets_values_get — Zellenwerte lesen

• sheets_values_update — Zellenwerte schreiben

• sheets_values_append — Zeilen anhängen

calendar (5 Tools)

• calendar_events_list — Termine auflisten

• calendar_events_get — Termindetails abrufen

• calendar_events_insert — Termine erstellen

• calendar_events_update — Termine aktualisieren

• calendar_events_delete — Termine löschen

docs (3 Tools)

• docs_get — Dokumentinhalt abrufen

• docs_create — Dokumente erstellen

• docs_batchUpdate — Dokument-Updates anwenden

gmail (4 Tools)

• gmail_messages_list — Nachrichten suchen

• gmail_messages_get — Eine Nachricht lesen

• gmail_threads_list — Threads suchen

• gmail_threads_get — Einen vollständigen Thread lesen

Gesamt: 24 Tools (gegenüber 200-400 in der alten Implementierung)

Neue Tools hinzufügen

Bearbeiten Sie src/services.ts, um Tool-Definitionen hinzuzufügen. Jedes Tool wird direkt auf einen gws CLI-Befehl abgebildet:

{
  name: "drive_files_list",           // MCP tool name
  description: "List files in Drive", // Shown to AI
  command: ["drive", "files", "list"],// gws CLI args
  params: [                           // Maps to --params JSON
    { name: "q", description: "Search query", type: "string", required: false },
  ],
  bodyParams: [                       // Maps to --json body
    { name: "name", description: "File name", type: "string", required: true },
  ],
}

Architektur

MCP Client (Claude) ←→ stdio ←→ gws-mcp-server ←→ gws CLI ←→ Google APIs

Der Server ist ein schlanker Wrapper: Er übersetzt MCP-Tool-Aufrufe in gws CLI-Aufrufe, übergibt --params und --json wie erforderlich und gibt die JSON-Ausgabe zurück.

Haftungsausschluss

Alle auf diesem Konto geäußerten Ansichten, Meinungen und Aussagen sind ausschließlich meine eigenen und werden in meiner persönlichen Eigenschaft getätigt. Sie spiegeln nicht die Ansichten, Positionen oder Richtlinien von Modular wider und sollten auch nicht als solche ausgelegt werden. Dieses Konto ist in keiner Weise mit Modular verbunden, von Modular autorisiert oder unterstützt.

Lizenz

MIT