google-calendar-mcp-serviceaccount

Ein minimaler MCP-Server, der einem KI-Agenten Lese- und Schreibzugriff auf einen Google-Kalender gewährt, authentifiziert als Dienstkonto anstelle von interaktivem OAuth.

Warum ein Dienstkonto

Die meisten Google-Kalender-MCP-Server verwenden OAuth: Die App bittet einen Menschen, sich anzumelden und seine Zustimmung zu erteilen, so wie es ein echtes Mehrbenutzerprodukt tun würde. Für einen persönlichen Assistenten, der nur Zugriff auf deinen eigenen Kalender benötigt, ist das mehr Aufwand als nötig – Veröffentlichung in der Produktion, verifizierte Domains, regelmäßige erneute Zustimmung.

Ein Dienstkonto überspringt das alles: Du teilst deinen Kalender mit der E-Mail-Adresse des Dienstkontos, genau wie mit einer anderen Person. Die Anmeldedaten laufen nicht ab, bis du sie widerrufst.

Kompromiss: Es funktioniert nur für Kalender, die du explizit per E-Mail teilen kannst (persönliche Google-Konten, die meisten Workspace-Einrichtungen) – es kann nicht so umfassend über das Konto eines Benutzers agieren wie eine vollständige OAuth-Genehmigung.

Kosten: Zum Zeitpunkt der Erstellung dieses Textes ist alles im untenstehenden Setup kostenlos – es muss kein Abrechnungskonto oder keine Kreditkarte mit dem Google Cloud-Projekt verbunden werden. Das kostenlose Kontingent der Calendar API übersteigt bei weitem, was ein persönlicher Assistent jemals nutzen wird. Das könnte sich in Zukunft ändern; prüfe im Zweifel die aktuellen Google Cloud-Preise.

Related MCP server: Google Calendar MCP Server

Werkzeuge

Kein delete_event aus Absicht – füge es selbst hinzu, wenn du möchtest, dass ein Agent Kalendereinträge löschen kann.

Einrichtung

Richtest du das mit Hilfe eines KI-Codierungsassistenten ein? Verweise ihn auf AGENTS.md – dort findest du die vollständige Schritt-für-Schritt-Anleitung sowohl für die menschliche als auch für die Agentenseite.

Manuell vorgehen:

1. In der Google Cloud Console: Erstelle ein Projekt, aktiviere die Calendar API, erstelle ein Dienstkonto (kein OAuth-Client) und lade dessen JSON-Schlüssel herunter.

2. Teile deinen Google-Kalender mit der E-Mail-Adresse des Dienstkontos, mit der Berechtigung „Änderungen an Ereignissen vornehmen“. Notiere die Kalender-ID: Für deinen eigenen primären Kalender ist das einfach deine E-Mail-Adresse; für jeden anderen Kalender findest du sie unter den Einstellungen dieses Kalenders → „Kalender integrieren“ → „Kalender-ID“.

3. python3 -m venv venv && ./venv/bin/pip install -r requirements.txt

4. Kopiere .env.example zu .env und fülle den Schlüsselpfad und deine Kalender-ID aus.

5. Registriere calendar_server.py bei deinem MCP-Client als stdio-Server und übergib diese beiden Variablen als dessen Umgebung.

Lizenz

MIT – siehe LICENSE.