Google Automation MCP

Google Workspace APIs für KI-Agenten – kein GCP-Projekt erforderlich.

Verwendet clasp für die Authentifizierung. Keine GCP-Konsole, kein OAuth-Zustimmungsbildschirm, keine Client-Geheimnisse. Einfach authentifizieren und loslegen.

Schnellstart

uvx google-automation-mcp auth   # 1. Browser sign-in via clasp
uvx google-automation-mcp        # 4. Run server

Der erste Durchlauf führt Sie durch drei einmalige Schritte:

1. gmcp auth – öffnet den Browser für die Google-Anmeldung (clasp OAuth)

2. Apps Script API aktivieren – gmcp auth prüft dies und fordert Sie auf, die Option unter https://script.google.com/home/usersettings auf EIN zu stellen (5 Sekunden)

3. Bereiche autorisieren – gmcp auth stellt einen Web-App-Router bereit und gibt eine URL aus. Öffnen Sie diese und klicken Sie auf "Zulassen", um Zugriff auf Gmail/Drive/Sheets/Calendar/Docs/Forms/Tasks zu gewähren

4. Fertig – führen Sie gmcp oder uvx google-automation-mcp aus, um den Server zu starten

Status jederzeit prüfen: gmcp status

Tipp: Verwenden Sie nach der Installation den Kurzalias gmcp.

Re-Autorisierung: Falls ein zukünftiges Update neue Bereiche hinzufügt, widerrufen Sie die App unter myaccount.google.com/permissions (suchen Sie nach "MCP-Router") und besuchen Sie dann erneut die Web-App-URL aus gmcp status.

Clasp Router vs. REST API

Workspace-Tools (Gmail, Drive, Sheets usw.) können in zwei Modi betrieben werden. Der Clasp-Router ist der Standard und erfordert kein GCP-Projekt. Die traditionelle Google API-Einrichtung erfordert das Erstellen eines GCP-Projekts, das Aktivieren von APIs, das Konfigurieren eines OAuth-Zustimmungsbildschirms, das Hinzufügen von Testbenutzern und das Erstellen von Anmeldeinformationen.

Tägliche Kontingente (kostenloses Google-Privatkonto)

Hinweis: Die Laufzeitlimits von Apps Script werden über alle Dienste hinweg geteilt. Das Limit von 90 Min/Tag gilt für die Gesamtausführungszeit, nicht pro Dienst. Bei ca. 2s pro Aufruf entspricht das ca. 2.700 Tool-Aufrufen/Tag. Vollständige Apps Script-Kontingente

Backend-Auswahl

Das Backend wird automatisch ausgewählt: Wenn GOOGLE_OAUTH_CLIENT_ID und GOOGLE_OAUTH_CLIENT_SECRET gesetzt sind, werden REST APIs verwendet. Andernfalls übernimmt der Clasp-Router die Workspace-Aufrufe.

Überschreiben Sie dies mit MCP_USE_ROUTER=true oder MCP_USE_ROUTER=false, um ein bestimmtes Backend zu erzwingen.

Für Multi-User-Produktionsbereitstellungen, die Ihre eigenen OAuth-Anmeldeinformationen erfordern:

export GOOGLE_OAUTH_CLIENT_ID='...'
export GOOGLE_OAUTH_CLIENT_SECRET='...'
gmcp auth --oauth21

Sicherheit: KI sieht niemals Anmeldeinformationen

Das MCP fungiert als Sicherheitsgrenze. Ihr KI-Agent ruft Tools auf; das MCP übernimmt die Authentifizierung intern.

MCP-Client-Konfiguration

Claude Desktop (Ein-Klick-Installation):

Laden Sie google-automation-mcp.dxt herunter und öffnen Sie es. Claude Desktop wird automatisch installiert.

Claude Code (~/.mcp.json):

{
  "mcpServers": {
    "google": {
      "type": "stdio",
      "command": "uvx",
      "args": ["google-automation-mcp"]
    }
  }
}

Claude Desktop (Manuell) (claude_desktop_config.json):

{
  "mcpServers": {
    "google": {
      "command": "uvx",
      "args": ["google-automation-mcp"]
    }
  }
}

Gemini CLI:

gemini extensions install github:sam-ent/google-automation-mcp

Verfügbare Tools (60)

Gmail (5)

search_gmail_messages · get_gmail_message · send_gmail_message · list_gmail_labels · modify_gmail_labels

Drive (10)

search_drive_files · list_drive_items · get_drive_file_content · create_drive_file · create_drive_folder · delete_drive_file · trash_drive_file · share_drive_file · list_drive_permissions · remove_drive_permission

Sheets (6)

list_spreadsheets · get_sheet_values · update_sheet_values · append_sheet_values · create_spreadsheet · get_spreadsheet_metadata

Calendar (5)

list_calendars · get_events · create_event · update_event · delete_event

Docs (5)

get_doc_content · search_docs · create_doc · modify_doc_text · append_doc_text

Forms (4)

get_form · create_form · add_form_question · get_form_responses

Tasks (6)

list_task_lists · get_tasks · create_task · update_task · delete_task · complete_task

Apps Script (17)

list_script_projects · get_script_project · get_script_content · create_script_project · update_script_content · delete_script_project · run_script_function · create_deployment · list_deployments · update_deployment · delete_deployment · list_versions · create_version · get_version · list_script_processes · get_script_metrics · generate_trigger_code

Auth (2)

start_google_auth · complete_google_auth

Multi-User-Unterstützung

Alle Tools akzeptieren user_google_email für die Isolierung der Anmeldeinformationen pro Benutzer:

search_gmail_messages(user_google_email="alice@example.com", query="is:unread")
search_gmail_messages(user_google_email="bob@example.com", query="is:unread")

Anmeldeinformationen werden separat gespeichert: ~/.secrets/google-automation-mcp/credentials/{email}.json

Apps Script: Google Workspace erweitern

Apps Script-Tools ermöglichen es Ihnen, Code bereitzustellen, der innerhalb von Google-Apps ausgeführt wird – Dinge, die REST APIs nicht können:

# Create a bound script with custom function
create_script_project(title="Validator", parent_id="SPREADSHEET_ID")
update_script_content(script_id="...", files=[{
    "name": "Code",
    "type": "SERVER_JS",
    "source": "function VALIDATE_EMAIL(e) { return /^[^@]+@[^@]+\\.[^@]+$/.test(e); }"
}])

Einschränkungen

run_script_function erfordert eine einmalige Einrichtung pro Skript: Öffnen Sie das Skript unter script.google.com -> Projekteinstellungen -> GCP-Projekt ändern -> Als API-ausführbar bereitstellen. Sobald konfiguriert, können Funktionen wiederholt aufgerufen werden. Alle anderen Tools funktionieren ohne diese Einrichtung.

CLI-Referenz

Kurzalias: gmcp (oder vollständiger Name: google-automation-mcp)

gmcp                 # Run server
gmcp setup           # Interactive setup wizard
gmcp auth            # Authenticate with clasp
gmcp auth --oauth21  # OAuth 2.1 for production
gmcp status          # Check auth status
gmcp version         # Show version

Entwicklung

git clone https://github.com/sam-ent/google-automation-mcp.git
cd google-automation-mcp
uv sync
uv run pytest tests/ -v  # 183 tests

Danksagungen

Basiert auf google_workspace_mcp von Taylor Wilsdon (MIT-Lizenz).

Lizenz

MIT