greenhouse

greenhouse

greenhouse.

A Greenhouse candidate — list, read, create, annotate.

ajouter à otoauth : —prefix : greenhouse_*

setup & usage

⚠ ta clé api greenhouse (harvest)

il te faut une clé harvest api greenhouse.

  • dans greenhouse, va dans configure → dev center → api credentials et crée une clé de type *harvest*
  • donne-lui les permissions candidats/jobs/applications/users
  • colle-la dans tes clés de connecteurs (ou laisse ton org partager la sienne)
  • doc éditeur : greenhouse.io
  • ⚠️ les écritures (créer un candidat, ajouter une note) exigent un on_behalf_of = l'id d'un utilisateur greenhouse, récupéré via greenhouse_users
  • ▸ ce que tu peux faire

    pilote ton ats greenhouse depuis la conversation : candidats, jobs, candidatures, notes.

  • « liste les candidats sur le job 123 » → greenhouse_candidate(op="list") (filtres job_id, email, created_after)
  • « montre-moi le candidat 456 et ses candidatures » → greenhouse_candidate
  • « ajoute une note sur le candidat 456 » → greenhouse_candidate(op="add_note") (il faut un user_id auteur, cf. greenhouse_users)
  • « quels jobs sont ouverts ? » → greenhouse_job(op="list") (status open/closed/draft)
  • ⚙ plusieurs comptes

    ce connecteur accepte plusieurs comptes : chaque credential posé devient un compte nommé (un nom par compte), à ton niveau, à celui de ton équipe ou de ton org.

  • le premier n'a pas besoin de nom ; à partir du deuxième, chacun porte le sien (le premier prend alors le nom « principal », renommable)
  • sans précision, l'agent prend le seul compte posé, sinon celui marqué par défaut ; sinon l'appel est refusé en nommant les comptes disponibles — jamais un choix au hasard
  • viser un compte pour un appel : _account="<nom>" sur l'outil ; les lister : oto_identity(op='list', connector='greenhouse') (scope='org' ou scope='group' pour ceux de l'org ou de l'équipe)
  • fixer le défaut : oto_identity(op='set', connector='greenhouse', identity_id='<nom>') ; renommer : op='rename' avec new_name
  • ⚠️ aucun outil ne parcourt les comptes tout seul : un total sur plusieurs comptes s'obtient en appelant chacun (_account) et en additionnant
  • outils

    chargement…

    utilisation

    claude code — installe le plugin oto — claude plugin marketplace add otomata-tech/oto-plugin — mcp + skill configurés.
    claude.ai — branche mcp.oto.cx/mcp en connecteur custom (guide)
    cli — pipx install oto-cli puis oto greenhouse …