Google Kalender AutoAuth MCP-Server

Ein Model Context Protocol (MCP)-Server für die Google Kalender-Integration in Claude Desktop mit automatischer Authentifizierungsunterstützung. Dieser Server ermöglicht KI-Assistenten die Verwaltung von Google Kalender durch natürliche Sprachinteraktionen.

Merkmale

Erstellen Sie Kalenderereignisse mit Titel, Beschreibung, Ort und Teilnehmern
Vorhandene Kalenderereignisse aktualisieren
Kalenderereignisse löschen
Ereignisdetails abrufen
Auflisten von Ereignissen innerhalb eines angegebenen Zeitraums
Suche nach Ereignissen nach Stichwort
Alle verfügbaren Kalender auflisten
Unterstützung für die Datums-/Uhrzeiteingabe in natürlicher Sprache (z. B. „morgen um 14 Uhr“, „nächsten Montag“)
Vollständige Integration mit der Google Kalender-API
Einfacher OAuth2-Authentifizierungsablauf mit automatischem Browserstart
Unterstützung für Anmeldeinformationen sowohl für Desktop- als auch für Webanwendungen
Globale Speicherung von Anmeldeinformationen für mehr Komfort

Installation und Authentifizierung

Installation über Smithery

So installieren Sie den Google Calendar Integration Server für Claude Desktop automatisch über Smithery :

npx -y @smithery/cli install @falgom4/calendar-mcp --client claude

Manuelle Installation

Erstellen Sie ein Google Cloud-Projekt und rufen Sie die Anmeldeinformationen ab:a. Erstellen Sie ein Google Cloud-Projekt:
- Gehen Sie zur Google Cloud Console
- Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus
- Aktivieren Sie die Google Kalender-API für Ihr Projekt
b. OAuth 2.0-Anmeldeinformationen erstellen:
- Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“
- Klicken Sie auf „Anmeldeinformationen erstellen“ > „OAuth-Client-ID“.
- Wählen Sie als Anwendungstyp entweder „Desktop-App“ oder „Webanwendung“
- Geben Sie ihm einen Namen und klicken Sie auf „Erstellen“.
- Für Webanwendungen fügen Sie http://localhost:3000/oauth2callback zu den autorisierten Umleitungs-URIs hinzu.
- Laden Sie die JSON-Datei mit den OAuth-Schlüsseln Ihres Clients herunter
- Benennen Sie die Schlüsseldatei in gcp-oauth.keys.json um
Authentifizierung ausführen:Sie können sich auf zwei Arten authentifizieren:a. Globale Authentifizierung (empfohlen):
# First time: Place gcp-oauth.keys.json in your home directory's .calendar-mcp folder mkdir -p ~/.calendar-mcp mv gcp-oauth.keys.json ~/.calendar-mcp/ # Run authentication from anywhere npx @nchufa/calendar auth
b. Lokale Authentifizierung:
# Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @nchufa/calendar auth
Der Authentifizierungsprozess wird:
- Suchen Sie nach gcp-oauth.keys.json im aktuellen Verzeichnis oder ~/.calendar-mcp/
- Wenn es im aktuellen Verzeichnis gefunden wird, kopieren Sie es nach ~/.calendar-mcp/
- Öffnen Sie Ihren Standardbrowser für die Google-Authentifizierung
- Anmeldeinformationen speichern als ~/.calendar-mcp/credentials.json
Notiz :
- Nach erfolgreicher Authentifizierung werden die Anmeldeinformationen global in ~/.calendar-mcp/ gespeichert und können von jedem Verzeichnis aus verwendet werden
- Die Anmeldeinformationen für Desktop-Apps und Webanwendungen werden unterstützt.
- Stellen Sie für die Anmeldeinformationen von Webanwendungen sicher, dass Sie http://localhost:3000/oauth2callback zu Ihren autorisierten Umleitungs-URIs hinzufügen.
In Claude Desktop konfigurieren:

Fügen Sie Ihrer Claude Desktop-Konfigurationsdatei Folgendes hinzu:

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "@nchufa/calendar"
      ]
    }
  }
}

Verfügbare Tools

Der Server bietet die folgenden Tools, die über Claude Desktop verwendet werden können:

1. Ereignis erstellen ( `create_event` )

Erstellt ein neues Kalenderereignis.

{
  "summary": "Team Meeting",
  "description": "Weekly team sync to discuss project progress",
  "location": "Conference Room A",
  "start": "2025-04-01T14:00:00",
  "end": "2025-04-01T15:00:00",
  "attendees": ["colleague@example.com", "manager@example.com"],
  "reminders": {
    "useDefault": false,
    "overrides": [
      {
        "method": "email",
        "minutes": 30
      },
      {
        "method": "popup",
        "minutes": 10
      }
    ]
  }
}

Datum/Uhrzeit in natürlicher Sprache werden ebenfalls unterstützt:

{
  "summary": "Coffee with John",
  "location": "Starbucks Downtown",
  "start": "tomorrow at 2:30pm",
  "end": "tomorrow at 3:30pm"
}

2. Ereignis abrufen ( `get_event` )

Ruft Details eines bestimmten Kalenderereignisses ab.

{
  "eventId": "abc123xyz456",
  "calendarId": "primary"
}

3. Update-Ereignis ( `update_event` )

Aktualisiert ein vorhandenes Kalenderereignis.

{
  "eventId": "abc123xyz456",
  "summary": "Updated Meeting Title",
  "location": "New Location",
  "start": "2025-04-01T15:00:00",
  "end": "2025-04-01T16:00:00"
}

4. Ereignis löschen ( `delete_event` )

Löscht ein Kalenderereignis.

{
  "eventId": "abc123xyz456",
  "calendarId": "primary"
}

5. Ereignisse auflisten ( `list_events` )

Listet Kalenderereignisse innerhalb eines angegebenen Zeitraums auf.

{
  "calendarId": "primary",
  "timeMin": "2025-04-01T00:00:00",
  "timeMax": "2025-04-07T23:59:59",
  "maxResults": 10,
  "orderBy": "startTime"
}

6. Ereignisse suchen ( `search_events` )

Sucht nach Ereignissen, die einer Abfrage entsprechen.

{
  "query": "meeting",
  "calendarId": "primary",
  "timeMin": "2025-04-01T00:00:00",
  "maxResults": 5
}

7. Kalender auflisten ( `list_calendars` )

Listet alle verfügbaren Kalender auf.

{}

Unterstützung für Datum/Uhrzeit in natürlicher Sprache

Der Server unterstützt verschiedene natürliche Sprachformate für Datum und Uhrzeit:

Bestimmte Daten: „2025-04-01T14:00:00“ (ISO-Format)
Einfache Verweise: „heute“, „morgen“, „jetzt“
Relative Zeiten: „2 Stunden später“, „3 Tage später“
Tagesangaben: „nächsten Montag“, „nächsten Dienstag“
Kombinierte Formate: „morgen 14 Uhr“, „Montag 15:30 Uhr“

Dies erleichtert das Erstellen und Aktualisieren von Ereignissen mithilfe von Anweisungen in natürlicher Sprache.

Sicherheitshinweise

OAuth-Anmeldeinformationen werden sicher in Ihrer lokalen Umgebung gespeichert ( ~/.calendar-mcp/ )
Der Server verwendet den Offline-Zugriff, um eine dauerhafte Authentifizierung aufrechtzuerhalten
Geben Sie Ihre Anmeldeinformationen niemals an die Versionskontrolle weiter und übergeben Sie sie nicht
Überprüfen und widerrufen Sie regelmäßig ungenutzte Zugriffe in Ihren Google-Kontoeinstellungen.

Fehlerbehebung

OAuth-Schlüssel nicht gefunden
- Stellen Sie sicher, dass sich gcp-oauth.keys.json entweder in Ihrem aktuellen Verzeichnis oder in ~/.calendar-mcp/ befindet.
- Überprüfen Sie die Dateiberechtigungen
Ungültiges Anmeldeinformationsformat
- Stellen Sie sicher, dass Ihre OAuth-Schlüsseldatei entweder web oder installed Anmeldeinformationen enthält
- Überprüfen Sie bei Webanwendungen, ob die Umleitungs-URI richtig konfiguriert ist
Port wird bereits verwendet
- Wenn Port 3000 bereits verwendet wird, geben Sie ihn bitte frei, bevor Sie die Authentifizierung ausführen
- Sie können den Prozess über diesen Port finden und stoppen

Beitragen

Beiträge sind willkommen! Senden Sie gerne einen Pull Request.

Lizenz

MIT

Danksagung

Besonderer Dank geht an GongRzhe und sein Calendar-Autoauth-MCP-Server- Projekt, das als Grundlage für diese Implementierung diente.

Unterstützung

Wenn Sie auf Probleme stoßen oder Fragen haben, melden Sie bitte ein Problem im GitHub-Repository.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Ermöglicht KI-Assistenten die Verwaltung von Google Kalender durch Interaktionen in natürlicher Sprache mit Funktionen wie dem Erstellen, Aktualisieren und Löschen von Ereignissen, der Suche im Kalender und der Unterstützung von Datums-/Uhrzeiteingaben in natürlicher Sprache.

Related MCP Servers

Google Calendar
GongRzhe
-
security
F
license
-
quality
Google Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.
Last updated -
5
0
5
JavaScript
Calendar AutoAuth MCP Server
GongRzhe
-
security
A
license
-
quality
Server for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.
Last updated -
22
6
JavaScript
MIT License
Metabase Server MCP
berry-street
-
security
F
license
-
quality
Enables AI assistants to interact with Metabase, providing access to dashboards, questions, databases, and tools for executing queries and viewing data through natural language.
Last updated -
JavaScript
Google Calendar MCP Server
am2rican5
-
security
A
license
-
quality
Integrates Google Calendar with AI assistants through the Model Context Protocol, allowing users to view and manage calendar events through natural language interaction.
Last updated -
237
TypeScript
MIT License

View all related MCP servers

Google Calendar AutoAuth MCP Server