lucca

lucca

lucca.

An employee of the Lucca directory — the roster, or one employee.

ajouter à otoauth : —prefix : lucca_*

setup & usage

⚠ your lucca api access

lucca uses a static api key and your instance's subdomain; each firm/employer enters their own, their data is only visible to them. generate the key from your lucca account or via your lucca contact.

  • api_key — api key generated in settings → api
  • domain — only the subdomain of your instance (e.g. acme for acme.ilucca.net), not the full url
  • enter these two fields in your oto connector keys under lucca

    ▸ browse the directory, absences, expenses and organization

    read-only.

  • lucca_employee(op="list") lists the reachable employees, lucca_employee(op="get") the detail of an employee by id
  • lucca_absence(op="list") the absences posted over a period (date required; the free-text comment is cut by default, fields=["*"] returns it), lucca_absence(op="get") the detail of an absence
  • lucca_leave_request(op="list") the leave requests (the approval workflow), lucca_leave_request(op="get") the detail of a request
  • lucca_expense_claim() the expense claims — no detail by id, lucca only exposes the list
  • lucca_department(op="list") the departments (employee lists are cut by default, fields=["*"] returns them), lucca_department(op="get") the detail of a department
  • lucca_establishment() the establishments — no detail by id, base and pagination different from the rest; the nested legal entity is cut by default
  • ⚙ multiple comptes

    this connector accepts multiple comptes: each stored credential becomes a named account (one name per compte), at your level, your team's or your org's.

  • the first one doesn't need a name; from the second on, each one carries its own (the first then takes the name "principal", renamable)
  • without specification, the agent takes the only stored compte, otherwise the one marked as default; otherwise the call is refused, naming the available comptes — never a random choice
  • target a compte for a call: _account="<name>" on the tool; list them: oto_identity(op='list', connector='lucca') (scope='org' or scope='group' for the org's or team's)
  • set the default: oto_identity(op='set', connector='lucca', identity_id='<name>'); rename: op='rename' with new_name
  • ⚠️ no tool walks through the comptes on its own: a total across several comptes is obtained by calling each one (_account) and adding up
  • 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 lucca …