Was macht gws-gmail-read?
Gmail: Nachricht lesen und deren Inhalt oder Header extrahieren.
Beschreibung
Mit diesem Skill können KI-Agenten eine bestimmte E-Mail aus Google Gmail abrufen und entweder den Nachrichtentext oder die Header-Daten (z. B. Absender, Betreff, Empfangszeit) auslesen. Es eignet sich für Aufgaben wie:
- Automatische Zusammenfassungen von eingehenden E-Mails
- Analyse von Nachrichteninhalten für Support-Tickets
- Extraktion von Metadaten für Archivierungs- oder Filterlogiken
- Integration in Chatbots oder Workflow-Automationen
Funktionsweise
- Der Agent übergibt die Nachrichten-ID (z. B.
msg-12345) sowie die gewünschte Aktion (readBodyoderreadHeaders). - Das Skill authentifiziert sich über die Google Workspace-API (OAuth 2.0).
- Es ruft die entsprechende Gmail-API-Methode auf und gibt die Daten zurück.
- Bei
readBodywird der Nachrichtentext (plain text oder HTML) extrahiert, beireadHeaderswerden die relevanten Header (From,To,Subject,Date) in strukturierter Form bereitgestellt.
Unterstützte Plattformen
- Claude Code
- Cursor
- Codex (GitHub Copilot)
- Andere KI-Agenten mit Google Workspace-Integration
Voraussetzungen
- Google Workspace-Konto mit Zugriff auf Gmail API
- Authentifizierung (OAuth 2.0 Client-ID und Secret)
- Nachrichten-ID der zu lesenden E-Mail
Beispielaufruf (CLI)
gws-gmail-read --message-id "msg-12345" --action readBody
gws-gmail-read --message-id "msg-12345" --action readHeaders
Hinweise
- Die Nachrichten-ID kann z. B. aus einer vorherigen
gws-gmail-list-Aktion stammen. - Bei großen Nachrichten wird nur die erste 1 MB des Texts abgerufen.
- HTML-Inhalte werden automatisch in Plain-Text konvertiert, sofern nicht anders angefordert.
Lizenz
Dieses Skill unterliegt der MIT-Lizenz.