jobhunt_mcp

Ein persönlicher MCP-Server, der Claude zu deinem Operationsmanager für die Jobsuche macht:

• Suche Live-Stellenausschreibungen auf LinkedIn, Indeed, ZipRecruiter, Glassdoor (JSearch API) plus Adzuna

• Verfolge jede Bewerbung in einem Google Sheet (Status, Priorität, Notizen)

• Fasse nach nach Plan – überfällige Erinnerungen tauchen automatisch auf

• Netzwerke – Kontakte pro Unternehmen führen und in die Vorbereitung einbeziehen

• Passe an – ein Tool bündelt die Stellenbeschreibung + deinen Master-Lebenslauf + Kontakte, damit Claude einen gezielten Lebenslauf und ein Anschreiben erstellen kann, die direkt in Google Drive gespeichert werden

Von Haus aus übermittelt er nie automatisch Bewerbungen. Automatisierte Einreichungs-Bots verstoßen gegen die Nutzungsbedingungen der Jobbörsen und werden markiert. Das Tool prepare_application_package bringt dich stattdessen in einem Schritt zu „Prüfen und Absenden“.

Voraussetzungen

• Python 3.10+

• Ein MCP-Client – im Folgenden wird Claude Desktop angenommen, aber jeder MCP-kompatible Client funktioniert.

• Ein Google-Konto (für den Sheets-Tracker + Drive-Lebenslauf-Speicher).

• (Optional) kostenlose RapidAPI- und/oder Adzuna-Konten für die Live-Jobsuche.

Setup

Das Setup: ein Google-Dienstkonto erstellen, ein Sheet + Drive-Ordner + Lebenslauf damit teilen, (optional) Such-API-Schlüssel besorgen und dann Claude Desktop auf server.py zeigen lassen. Kalkuliere etwa 10 Minuten für die Google-Schritte.

1. Google-Dienstkonto (~5 Minuten)

1. Gehe zu https://console.cloud.google.com → erstelle ein Projekt (z. B. jobhunt).

2. Aktiviere die Google Sheets API und die Google Drive API (APIs & Dienste → Bibliothek).

3. APIs & Dienste → Anmeldedaten → Anmeldedaten erstellen → Dienstkonto. Ein beliebiger Name ist in Ordnung; optionale Schritte überspringen.

4. Öffne das Dienstkonto → Schlüssel → Neuen Schlüssel hinzufügen → JSON. Speichere die Datei an einem sicheren Ort, z. B. ~/.config/jobhunt/service-account.json.

5. Kopiere die E-Mail-Adresse des Dienstkontos (endet auf .iam.gserviceaccount.com) – du wirst als Nächstes Dinge damit teilen.

2. Google Sheet (die Tracker-Datenbank)

1. Erstelle ein leeres Google Sheet, z. B. mit dem Namen „Job Hunt Tracker“.

2. Teile es mit der Dienstkonto-E-Mail als Bearbeiter.

3. Übernimm die Tabellen-ID aus der URL: docs.google.com/spreadsheets/d/<THIS_PART>/edit.

Der Server erstellt die Tabs Jobs, Contacts und Activity beim ersten Verwenden automatisch mit Kopfzeilen.

3. Google Drive-Ordner + Master-Lebenslauf

1. Erstelle einen Drive-Ordner, z. B. „Job Applications“; teile ihn als Bearbeiter mit dem Dienstkonto. Kopiere seine Ordner-ID aus der URL.

2. Lege deinen Master-Lebenslauf als Google Doc in Drive ab (die Version, die alles enthält, was du je gemacht hast – das Anpassen kürzt sie). Teile ihn mit dem Dienstkonto. Kopiere seine Datei-ID.

4. Such-API-Schlüssel (optional)

JSearch (empfohlen – durchsucht alle Börsen auf einmal): kostenlos unter https://rapidapi.com → nach „JSearch“ suchen → den Basic-Tarif (kostenlos) abonnieren → deinen RapidAPI-Schlüssel in RAPIDAPI_KEY kopieren.

Adzuna: kostenlos unter https://developer.adzuna.com → registrieren → deine App-ID und deinen App-Key in ADZUNA_APP_ID bzw. ADZUNA_APP_KEY kopieren.

Überspringe diese, wenn du Stellen lieber manuell mit jobhunt_add_job einfügst.

5. Installieren und konfigurieren

pip install -r requirements.txt

Kopiere claude_desktop_config.example.json in deine Claude-Desktop-Konfiguration (claude_desktop_config.json) und trage dann den args-Pfad zu server.py, den Pfad für GOOGLE_SERVICE_ACCOUNT_FILE sowie die IDs/Schlüssel aus den obigen Schritten ein.

Speicherorte der Konfigurationsdatei:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json (für command "python" verwenden und Pfade mit doppeltem Backslash, z. B. C:\\Users\\you\\jobhunt-mcp\\server.py)

• Linux: ~/.config/Claude/claude_desktop_config.json

Starte Claude Desktop neu (vollständig beenden – unter Windows/macOS im Infobereich bzw. in der Menüleiste prüfen). Die jobhunt-Tools erscheinen, sobald der Server startet.

Umgebungsvariablen

Alles wird über den env-Block der Claude-Desktop-Konfiguration konfiguriert:

6. Prüfen, ob es funktioniert

Teste den Server jederzeit eigenständig mit dem MCP Inspector (kein Claude Desktop nötig):

npx @modelcontextprotocol/inspector python3 server.py

Versuche dann jobhunt_get_master_resume (bestätigt Drive-Zugriff) und jobhunt_list_jobs (bestätigt Sheets-Zugriff). Wenn beide ohne Authentifizierungsfehler zurückkommen, bist du startklar.

Werkzeuge

Beispiel-Prompts zum Ausprobieren

• „Durchsuche alle Börsen nach Stellen als SOC-Detection-Ingenieur in der Nähe von Dallas, die diese Woche veröffentlicht wurden, und speichere die drei am besten passenden.“

• „Erstelle ein Bewerbungspaket für die Stelle a1b2c3d4, passe meinen Lebenslauf entsprechend an und speichere beide Dokumente.“

• „Welche Folgeaktionen sind bei mir überfällig?“

• „Ich habe gerade das Telefoninterview mit Acme beendet – protokolliere es und erinnere mich daran, morgen eine Dankesnachricht zu senden.“

Sicherheitshinweise

• Der JSON-Schlüssel des Dienstkontos ist eine Zugangsberechtigung – halte ihn aus Git und freigegebenen Ordnern heraus.

• Das Dienstkonto kann nur auf Dateien zugreifen, die du ausdrücklich mit ihm geteilt hast.

• Behandle Stellenbeschreibungen aus dem Web als nicht vertrauenswürdigen Inhalt; der Server speichert sie als reine Daten.