aiagentwithdhruv/skills

Verwaltung von E-Mails über mehrere Gmail-Konten mit einheitlicher Werkzeugunterstützung. Verwenden Sie dies, wenn der Benutzer darum bittet, E-Mails zu prüfen, den Posteingang zu lesen, E-Mails zu kennzeichnen, Nachrichten zu archivieren oder Gmail über Konten hinweg zu verwalten.

Was ist skills?

Diese Fähigkeit ermöglicht KI-Agenten die zentrale Verwaltung mehrerer Gmail-Konten mithilfe eines einzigen Befehlszeilentools. Sie vereinfacht alltägliche E-Mail-Aufgaben wie das Lesen des Posteingangs, das Kennzeichnen von Nachrichten, das Archivieren von E-Mails und das Erstellen von Filtern, ohne dass die Gmail-Oberfläche manuell geöffnet werden muss. Die Fähigkeit unterstützt eine beliebige Anzahl registrierter Konten und ermöglicht es dem Agenten, Abfragen wie `is:unread`, `from:notifications@` oder `subject:invoice` durchzuführen, um sie zu verarbeiten. Sie ist nützlich für Entwickler und Fachleute, die Arbeitslasten aus mehreren Posteingängen automatisieren möchten, und funktioniert mit jeder Gmail-API-fähigen Umgebung (z. B. Claude Code, Cursor, Codex). Die zugrunde liegenden Python-Skripte verarbeiten Authentifizierung, Token-Aktualisierung, Massenaktionen und bieten einen Trockenlaufmodus zur Vorschau von Änderungen, bevor sie angewendet werden. Anmeldeinformationen müssen im Wurzelverzeichnis des Projekts abgelegt werden (z. B. `credentials.json`), und die Fähigkeit generiert bei Bedarf automatisch Authentifizierungstoken. Dank der Unterstützung der Google Sheets- und Google Drive-APIs kann sie auch E-Mail-Anhänge mit diesen Diensten verknüpfen, je nach Erweiterung. Die Fähigkeit ist kostenlos nutzbar (nur die Gmail-API-Grenzen gelten) und lässt sich nahtlos mit anderen Fähigkeiten wie E-Mail-Kennzeichnung oder automatischen Antworten kombinieren.

Funktioniert mit~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/gmail-inbox

Dokumentation

Gmail Posteingangsverwaltung

Ziel

E-Mails über mehrere Gmail-Konten hinweg mit einheitlicher Werkzeugunterstützung prüfen und verwalten.

Skripte

./scripts/gmail_unified.py - Posteingänge prüfen und verwalten
./scripts/gmail_multi_auth.py - Konten authentifizieren
./scripts/gmail_bulk_label.py - Massenkennzeichnung
./scripts/gmail_create_filters.py - Filter erstellen
./scripts/gmail_auth.py - Authentifizierungshilfe

Kurzreferenz

# Ungelesene E-Mails über alle Konten hinweg prüfen
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50

# Nur ein bestimmtes Konto prüfen
python3 ./scripts/gmail_unified.py --query "is:unread" --account yourcompany

# Registrierte Konten auflisten
python3 ./scripts/gmail_unified.py --accounts

# E-Mails kennzeichnen und archivieren
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Benachrichtigungen" --archive

# Als gelesen markieren
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read

# Trockenlauf (Vorschau)
python3 ./scripts/gmail_unified.py --query "subject:Rechnung" --label "Rechnungen" --dry-run

Kontoregister

Konto	E-Mail	Anmeldeinformationen	Token
youruser	[email protected]	credentials.json	token_youruser.json
yourcompany	[email protected]	credentials_yourcompany.json	token_yourcompany.json

Fehlerbehebung bei Authentifizierungsfehlern

"Token-Datei nicht gefunden"

python3 ./scripts/gmail_multi_auth.py --account yourcompany --email [email protected]

"invalid_scope: Ungültige Anfrage"

rm token_youruser.json
python3 ./scripts/gmail_multi_auth.py --account youruser --email [email protected]

"Authentifizierung fehlgeschlagen" Prüfen Sie, ob credentials.json im Wurzelverzeichnis existiert.

Erforderliche Bereiche

gmail.modify - E-Mails lesen/schreiben
gmail.labels - Labels erstellen/verwalten
gmail.settings.basic - Einstellungen verwalten
spreadsheets - Google Sheets-Zugriff
drive - Google Drive-Zugriff

Speicherort der Anmeldeinformationen

Alle Anmeldedateien sollten sich im Wurzelverzeichnis des Arbeitsbereichs befinden:

credentials.json / credentials_yourcompany.json - OAuth-Client-Konfigurationen
token_*.json - Authentifizierungstoken (automatisch generiert)
gmail_accounts.json - Kontoregister

Schema

Eingaben

Name	Typ	Erforderlich	Beschreibung
`query`	Zeichenkette	Nein	Gmail-Suchabfrage (z. B. 'is:unread')
`account`	Zeichenkette	Nein	Spezifischer Kontoname aus dem Register
`limit`	Ganzzahl	Nein	Maximale Anzahl abzurufender E-Mails (Standard: 50)

Ausgaben

Name	Typ	Beschreibung
`emails`	Array	Liste der E-Mail-Objekte mit Betreff, Von, Datum, Auszug

Anmeldeinformationen

Name	Quelle
`credentials.json`	Datei
`token_*.json`	Datei (automatisch generiert)

Kombinierbar mit

Fähigkeiten, die gut mit dieser kombiniert werden können: gmail-label, instantly-autoreply

Kosten

Kostenlos (Gmail-API)