ComposioHQ/Lever-Automation

Lever Automation

Automatisieren Sie Ihre Recruiting-Operationen im Lever ATS direkt über Claude Code. Verwalten Sie Stellenausschreibungen, verfolgen Sie Kandidaten-Pipelines, aktualisieren Sie Anforderungen und durchsuchen Sie Opportunities, ohne Ihr Terminal zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/lever

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Lever-Konto, wenn Sie dazu aufgefordert werden, indem Sie einen beliebigen Lever-Befehl ausführen. Der Agent stellt einen OAuth-Link zur Authentifizierung bereit.
3. Stellen Sie sicher, dass Ihr Lever-API-Schlüssel über ausreichende Bereiche für die von Ihnen benötigten Operationen verfügt (Lese-/Schreibzugriff auf Stellenausschreibungen, Opportunities, Anforderungen).

---

Kern-Workflows

1. Stellenausschreibungen auflisten und filtern

Rufen Sie alle Stellenausschreibungen mit optionaler Filterung nach Status, Team, Abteilung, Standort oder Anstellungsart ab.

Tool: LEVER_LIST_POSTINGS

Wichtige Parameter:

• state – filtern nach published, internal, closed, draft, pending, rejected
• team, department, location, commitment – Ergebnisse nach organisatorischen Attributen eingrenzen
• limit (1-100) und offset – durch große Bestände an Stellenausschreibungen blättern
• tag – nach dem Tag der Stellenausschreibung filtern

Beispiel-Prompt: "Liste alle veröffentlichten Engineering-Stellenausschreibungen in Lever auf"

---

2. Kandidaten-Opportunities durchsuchen

Listen Sie alle Opportunities in der Einstellungspipeline mit umfassender Filterung für Pipeline-Analysen und Kandidatenverfolgung auf.

Tool: LEVER_LIST_OPPORTUNITIES

Wichtige Parameter:

• posting_id, stage_id, tag – nach Stellenausschreibung, Pipeline-Stufe oder Tag filtern
• email, contact_id – Opportunities für einen bestimmten Kandidaten finden
• archived – nach Archivierungsstatus filtern (true/false)
• created_at_start, created_at_end – Datumsbereichsfilter (ISO 8601)
• expand – erweitern Sie applications, contact, owner, stage, stageChanges, sources, sourcedBy zu vollständigen Objekten

Beispiel-Prompt: "Zeige mir alle aktiven Opportunities für die Senior Engineer Stellenausschreibung, erweitert mit Kontaktdetails"

---

3. Details einer Opportunity abrufen

Rufen Sie umfassende Details zu einer einzelnen Kandidaten-Opportunity ab, einschließlich Kontaktinformationen, Stufenfortschritt, Quellen und Bewerbungen.

Tool: LEVER_GET_OPPORTUNITY

Wichtige Parameter:

• opportunity (erforderlich) – die eindeutige UID der Opportunity
• expand – durch Kommas getrennte Felder zum Erweitern: contact, stage, owner

Beispiel-Prompt: "Hole vollständige Details für Opportunity 31c9716c-d4e3-47e8-a6a1-54078a1151d6 mit erweitertem Kontakt und Stufe"

---

4. Anforderungen verwalten

Erstellen, listen, aktualisieren und löschen Sie Anforderungen (Requisitions), um den Personalbedarf und die Einstellungsanforderungen zu verfolgen.

Tools: LEVER_LIST_REQUISITIONS, LEVER_GET_REQUISITION, LEVER_UPDATE_REQUISITION, LEVER_DELETE_REQUISITION

Für die Aktualisierung sind folgende Felder erforderlich:

• requisition (erforderlich) – UUID der Anforderung
• requisitionCode (erforderlich) – eindeutiger Code wie REQ-001
• name (erforderlich) – Titel der Anforderung
• headcountTotal (erforderlich) – Anzahl der Positionen (mindestens 1)
• status – open oder closed
• Optional: hiringManager, owner, department, team, location, compensationBand

Beispiel-Prompt: "Aktualisiere Anforderung REQ-001, erhöhe den Personalbestand auf 3 und ändere den Status auf offen"

---

5. Pipeline-Stufen anzeigen

Rufen Sie alle in Ihrem Lever-Konto konfigurierten Einstellungspipeline-Stufen ab.

Tool: LEVER_LIST_STAGES

Wichtige Parameter:

• limit (1-100) – maximale Elemente pro Seite
• offset – Paginierungstoken aus der vorherigen Antwort

Beispiel-Prompt: "Liste alle Pipeline-Stufen in unserem Lever-Konto auf"

---

6. Tags verwalten

Listen Sie alle Tags auf, die zur Kategorisierung von Kandidaten, Opportunities und Stellenausschreibungen verwendet werden.

Tool: LEVER_LIST_TAGS

Wichtige Parameter:

• limit – maximale Elemente pro Seite
• offset – Paginierungstoken

Beispiel-Prompt: "Zeige alle Kandidaten-Tags in Lever an"

---

Bekannte Fallstricke

• Paginierung für große Datensätze erforderlich: LEVER_LIST_OPPORTUNITIES und LEVER_LIST_POSTINGS geben standardmäßig maximal 100 Ergebnisse pro Seite zurück. Überprüfen Sie immer auf ein offset-Token in der Antwort und iterieren Sie, um vollständige Ergebnisse zu erhalten.
• Format des Expand-Parameters: Das expand-Feld bei LEVER_LIST_OPPORTUNITIES akzeptiert ein Array von Zeichenfolgen, während es bei LEVER_GET_OPPORTUNITY und LEVER_GET_REQUISITION eine durch Kommas getrennte Zeichenfolge akzeptiert. Befolgen Sie das genaue Schema für jedes Tool.
• Aktualisierungen von Anforderungen sind vollständige Ersetzungen: LEVER_UPDATE_REQUISITION erfordert alle Pflichtfelder (requisitionCode, name, headcountTotal), auch wenn Sie nur ein Feld ändern möchten. Rufen Sie zuerst immer die aktuelle Anforderung mit LEVER_GET_REQUISITION ab.
• Zeitstempel: Opportunity-Datumsfilter verwenden das ISO-8601-Format, während LEVER_LIST_POSTINGS für updated_at_start Unix-Zeitstempel in Millisekunden verwendet.
• Verbindungsberechtigungen: Schreiboperationen (Anforderungen aktualisieren/löschen) schlagen fehl, wenn Ihrem API-Token die erforderlichen Berechtigungen fehlen, selbst wenn Lesevorgänge erfolgreich sind.

---

Kurzreferenz

Tool-Slug	Beschreibung
LEVER_LIST_POSTINGS	Alle Stellenausschreibungen mit Filterung nach Status, Team, Abteilung auflisten
LEVER_LIST_OPPORTUNITIES	Kandidaten-Opportunities mit Pipeline-Filterung auflisten
LEVER_GET_OPPORTUNITY	Detaillierte Informationen zu einer einzelnen Opportunity abrufen
LEVER_GET_REQUISITION	Eine einzelne Anforderung anhand der ID abrufen
LEVER_LIST_REQUISITIONS	Alle Anforderungen mit Status-/Code-Filterung auflisten
LEVER_UPDATE_REQUISITION	Eine vorhandene Anforderung aktualisieren (vollständige Ersetzung)
LEVER_DELETE_REQUISITION	Eine Anforderung löschen/archivieren
LEVER_LIST_STAGES	Alle Pipeline-Stufen auflisten
LEVER_LIST_TAGS	Alle Tags zur Kategorisierung auflisten

---

Bereitgestellt von Composio