google-mcp-server

Hendrik0609/google-mcp-server

3.2

If you are the rightful owner of google-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Google MCP Server provides a protocol server for Gmail and Google Calendar with write access, enabling users to manage emails and calendar events programmatically.

Tools
5
Resources
0
Prompts
0

Google MCP Server

MCP Server für Gmail und Google Calendar mit Schreibzugriff.

🔒 Security Notice

WICHTIG: Wenn du dieses Repository vor dem 31. Oktober 2025, 17:00 Uhr geklont hast, enthielt die Git History OAuth Credentials im Bundle. Diese wurden entfernt. Falls du Admin bist:

  1. Erstelle neue OAuth Credentials in der Google Cloud Console
  2. Lösche die alten Credentials (sind kompromittiert)
  3. Erstelle ein neues Bundle mit den neuen Credentials
  4. Verteile das neue Bundle an dein Team

Details siehe .

Features

  • Gmail

    • E-Mails senden
    • Entwürfe erstellen
    • HTML-Formatierung

  • Google Calendar

    • Events erstellen
    • Events aktualisieren
    • Events löschen

Installation

Für Team-Admins

Wenn du diesen Server für dein Team bereitstellen möchtest:

👉 Siehe für die vollständige Anleitung zum Einrichten eines zentralen Google Cloud Projekts.

Für Team-Mitglieder

Wenn dein Admin bereits ein Bundle bereitgestellt hat:

👉 Siehe für die Installationsanleitung.

Für Einzelnutzer (eigenes Google Cloud Projekt)

Klicke hier für die Einzelnutzer-Anleitung
Voraussetzungen
  • Python 3.11 oder höher
  • Google Cloud Project mit aktivierten APIs (Gmail, Calendar)
  • OAuth 2.0 Credentials
Schritt 1: Google Cloud Projekt einrichten
  1. Gehe zu Google Cloud Console
  2. Erstelle ein neues Projekt
  3. Aktiviere Gmail API und Calendar API
  4. Erstelle OAuth 2.0 Credentials (Desktop App)
  5. Lade credentials.json herunter
Schritt 2: Installation

Option A: MCPB Bundle

  1. Bundle herunterladen
  2. credentials.json ins Bundle-Verzeichnis kopieren
  3. Bundle neu packen: mcpb pack bundle google-mcp-server.mcpb
  4. Bundle in Claude Desktop installieren
  5. Claude Desktop starten - Authentifizierung erfolgt automatisch beim ersten Nutzen!

Option B: Manuelle Installation

  1. Repository klonen:

    git clone https://github.com/USERNAME/REPO.git
cd google-mcp-server

  2. Dependencies installieren:

    pip install -r requirements.txt

  3. Credentials konfigurieren:

    mkdir -p ~/.config/google-mcp
cp credentials.json ~/.config/google-mcp/

  4. Authentifizieren:

    python3 authenticate.py

  5. Claude Desktop Config:

    {
  "mcpServers": {
    "google": {
      "command": "python3",
      "args": ["/pfad/zu/server.py"]
    }
  }
}

Verwendung

Nach der Installation stehen folgende Tools in Claude zur Verfügung:

send_email

{
  "to": "empfaenger@example.com",
  "subject": "Betreff",
  "body": "Nachricht",
  "cc": "cc@example.com"  // optional
}

create_draft

{
  "to": "empfaenger@example.com",
  "subject": "Betreff",
  "body": "Nachricht"
}

create_calendar_event

{
  "summary": "Meeting Titel",
  "start_time": "2025-10-27T14:00:00",
  "end_time": "2025-10-27T15:00:00",
  "description": "Beschreibung",  // optional
  "location": "Ort",  // optional
  "attendees": ["person@example.com"]  // optional
}

update_calendar_event

{
  "event_id": "abc123",
  "summary": "Neuer Titel",  // optional
  "start_time": "2025-10-27T15:00:00"  // optional
}

delete_calendar_event

{
  "event_id": "abc123"
}

Entwicklung

MCPB Bundle erstellen

  1. MCPB CLI installieren

    npm install -g @anthropic-ai/mcpb

  2. Bundle packen

    cd bundle
mcpb pack . ../google-mcp-server.mcpb

  3. SHA-256 Hash generieren

    sha256sum google-mcp-server.mcpb

Bundle validieren

mcpb validate manifest.json
mcpb info google-mcp-server.mcpb

Sicherheit

  • OAuth Tokens werden lokal gespeichert (~/.config/google-mcp/)
  • Tokens werden niemals im Code oder Bundle gespeichert
  • Jeder Nutzer muss eigene Google Cloud Credentials verwenden
  • Scopes: gmail.send, gmail.readonly, gmail.compose, calendar, calendar.events

Lizenz

MIT

Support

Bei Problemen bitte ein Issue auf GitHub erstellen.

⚠️ WICHTIG: Bundle Distribution

Das Bundle wird NICHT mehr auf GitHub bereitgestellt!

Warum?

Das Bundle enthält OAuth Credentials (Client ID/Secret) und darf aus Sicherheitsgründen nicht öffentlich verfügbar sein.

Für Team-Admins

Bundle erstellen:

  1. Credentials vorbereiten:

    # Deine credentials.json ins bundle/ Verzeichnis kopieren
cp ~/Downloads/credentials.json bundle/credentials.json

  2. Bundle packen:

    cd bundle
zip -r ../google-mcp-server.mcpb * -x "*.pyc" -x "*__pycache__*"
cd ..

  3. SHA-256 Hash generieren:

    sha256sum google-mcp-server.mcpb

  4. Bundle verteilen via:

    • Internes File-Share
    • Private Cloud-Storage (Nextcloud, OneDrive, etc.)
    • Direkter Transfer
    • NICHT via öffentliches GitHub!

Für Team-Mitglieder

Erhalte das Bundle von deinem Admin und folge dann der Anleitung.

✨ Neu: Device Code Flow

Die Authentifizierung erfolgt jetzt automatisch beim ersten Start:

  • Kein separates authenticate.py mehr nötig
  • Starte einfach Claude Desktop
  • Folge den Anweisungen in den Logs
  • Gib den Code bei google.com/device ein
  • Fertig!