Connect your AI to Lucca API V3

What your AI can do with Lucca API V3

Once connected, these tools appear automatically in your AI assistant:

• list_usersread-only

  List users from the directory. Optionally filter by email and include former employees.

• get_userread-only

  Get one user's details. Pass a comma-separated `fields` list to customize.

• list_departmentsread-only

  List the organization's departments.

• list_leave_requestsread-only

  List leave requests (Timmi Absences), pending or already decided.

• list_leavesread-only

  List actually-booked leaves over a date range (Timmi Absences).

• decide_leave_requestwrite · needs approval

  Approve or deny a pending leave request. A comment is required when denying.

• list_expense_claimsread-only

  List Cleemy expense claims, optionally filtered by owner and status.

• list_timesheetsread-only

  List timesheets (Timmi), optionally filtered by owner and date range.

• list_time_entriesread-only

  List time entries (Timmi), optionally filtered by owner and date range.

• list_user_locationsread-only

  List where employees are working (Timmi Office) over a date range.

• list_work_locationsread-only

  List the available work locations / sites (Timmi Office).

• create_userwrite · needs approval

  Create a user in the directory. Pass the full Lucca user object in `user` (Lucca requires firstName, lastName, login, mail, dtContractStart, legalEntityId, employeeNumber, departmentId, managerId, rolePrincipalId, habilitedRoles, birthDate, calendarId, cultureID).

• update_userwrite · needs approval

  Update a user (full replace — PUT). Pass the complete Lucca user object in `user`; omitted required fields will be cleared, so include all of them.

• list_expenseclaimitemsread-only

  Retrieve a list of `expenseClaimItems`.

• get_expenseclaimitemread-only

  Retrieve an expense claim item by its identifier.

• create_expenseclaimwrite · needs approval

  When a user wants to declare his expenses, he creates an `ExpenseClaim`. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_expensetempitemsread-only

  Retrieve a list of `ExpenseTempItems`.

• create_temporary_expensewrite · needs approval

  Create a new temporary-expense-item. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_expensetempitemread-only

  Retrieve an temporary expense item by its identifier.

• update_expensetempitemwrite · needs approval

  Update a temporary expense item by its identifier. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• create_expense_accounting_exportwrite · needs approval

  Create a new export and retrieve the export content directly in the response body for a given business-establishment. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_work_contractsread-only

  Retrieve a paginated collection of work-contracts.

• get_work_contractread-only

  Retrieve a single work-contract by its ID.

• list_booked_documentsread-only

  List booked-documents (i.e.

• create_commitment_requestwrite · needs approval

  Trigger the approval workflow for a purchase commitment. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_cost_centersread-only

  List cost-centers.

• create_cost_centerwrite · needs approval

  Create a new cost-center. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_cost_centerread-only

  Retrieve a cost-center by its ID.

• update_cost_centerwrite · needs approval

  Update a cost-center. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_documentwrite · needs approval

  Delete a document. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_documentread-only

  Retrieve a document by its ID.

• update_documentwrite · needs approval

  Update a document's information (e.g. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_invoiceread-only

  Retrieve an invoice by its ID.

• update_invoicewrite · needs approval

  Update an invoice. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_invoice_confirmationsread-only

  List confirmations for an invoice.

• confirm_invoicewrite · needs approval

  Confirm (approve) an invoice. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_naturesread-only

  List natures.

• create_naturewrite · needs approval

  Create a new nature. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_natureread-only

  Retrieve a nature by its ID.

• update_naturewrite · needs approval

  Update a nature. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_purchasesread-only

  List purchases.

• create_purchasewrite · needs approval

  Create a Purchase. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_purchaseread-only

  Retrieve a purchase by its ID.

• close_purchasewrite · needs approval

  Close a purchase. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• create_commitmentwrite · needs approval

  Create a commitment. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• cancel_commitment_requestwrite · needs approval

  Cancel a commitment-request. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_suppliersread-only

  List suppliers.

• create_supplierwrite · needs approval

  Create a new supplier. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_supplierread-only

  Retrieve a supplier by its ID.

• update_supplierwrite · needs approval

  Update a supplier. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• import_cost_centerswrite · needs approval

  Import a list of cost-centers. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_inbox_documentsread-only

  List documents waiting to be processed in the inbox.

• update_inbox_documentwrite · needs approval

  Update an inbox document and optionally attach or create a purchase. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• book_inbox_documentwrite · needs approval

  Book (validate) a document from the inbox. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_vat_ratesread-only

  List V.A.T.

• list_department_treeread-only

  List all departments as a tree.

• get_departmentread-only

  Retrieve a single Department by its unique identifier.

• list_structure_departmentsread-only

  List departments.

• get_structure_departmentread-only

  Retrieve a department by its ID.

• list_establishmentsread-only

  Retrieve a list of establishments.

• list_legal_unitsread-only

  Retrieve a paginated list of legal-units.

• list_fixed_itemsread-only

  Retrieve fixed remuneration items matching a set of filters.

• list_fixed_nature_categoriesread-only

  List fixed-nature categories.

• list_fixed_naturesread-only

  Retrieve all existing fixed natures.

• get_fixed_natureread-only

  Retrieve a single fixed nature from its identifier.

• list_variable_itemsread-only

  Retrieve variable remuneration items matching a set of filters.

• create_variable_itemwrite · needs approval

  Create a new variable item attached to an employee work contract. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_variable_itemwrite · needs approval

  Delete a variable-item. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_variable_itemread-only

  Retrieve a single variable item by id.

• update_variable_itemwrite · needs approval

  Update a variable-item. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_variable_nature_categoriesread-only

  List variable-nature-categories.

• list_variable_naturesread-only

  Retrieve all existing variable natures.

• get_variable_natureread-only

  Retrieve a single variable nature from its identifier.

• list_realized_trainingsread-only

  Retrieve a paginated list of realized-trainings for all employees who were present at a closed session.

• list_training_categoriesread-only

  Retrieve a paginated list of training-categories.

• list_training_providersread-only

  Retrieve a paginated list of training-providers.

• list_trainingsread-only

  Retrieve a paginated list of trainings.

• create_trainingwrite · needs approval

  Creates a training with the state 'ready', which by default is not displayed in the public catalog. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_trainingread-only

  Retrieve a training.

• list_realized_trainings_v2read-only

  Retrieve a paginated list of realized trainings.

• create_realized_training_v2write · needs approval

  Create a new realized training. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_realized_training_v2write · needs approval

  Delete a realized training by its id. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_realized_training_v2read-only

  Retrieve a single realized-training by its id.

• list_training_demandsread-only

  Retrieve a paginated list of training-demands that satisfy the query filters.

• list_user_datesread-only

  Retrieve a list of UserDates.

• list_workcycleexceptionsread-only

  Retrieve a paginated list of WorkCycleExceptions that satisfy the given query filters.

• get_workcycleexceptionread-only

  Retrieve a single WorkCycleException by its ID.

• list_employee_assignmentsread-only

  List Employee Assignments. You may not benefit from this feature.

• list_shiftoverridesread-only

  Retrieve a paginated list of ShiftOverrides that satisfy the given query filters.

• list_working_time_arrangementsread-only

  List Working Time Arrangements. You may not benefit from this feature.

• get_working_time_arrangementread-only

  Get a working time arrangement by id. Beta feature at Lucca: the account may not have it.

• list_collective_schedules_from_a_working_time_arrangementread-only

  List the collective schedules of a working time arrangement. Beta feature at Lucca: the account may not have it.

• get_collective_schedule_from_a_working_time_arrangementread-only

  Get one collective schedule of a working time arrangement. Beta feature at Lucca: the account may not have it.

• get_leave_requestread-only

  Retrieve a single Leave Request by its unique identifier.

• get_leaveread-only

  Retrieve a single Leave by its unique identifier.

• list_sickleavecertificatesread-only

  Retrieve a paginated list of SickLeaveCertificate objects, which contain further information about certain types of leaves.

• get_sickleavecertificateread-only

  Retrieve a single SickLeaveCertificate.

• get_import_user_locations_analysisread-only

  Retrieve the analysis of the Import User Locations API request with the create parameter set to false.

• get_import_user_locations_progressread-only

  Retrieve the progress of the Import User Locations API request.

• get_import_user_locations_resultsread-only

  Retrieve the results of the Import User Locations API request with the create parameter set to true.

• get_specific_userlocationread-only

  Get specific userLocation by id.

• get_specific_worklocationread-only

  Get a specific work location by id.

• list_organizationsread-only

  List organizations.

• list_project_financialsread-only

  Retrieve all financial metrics on projects.

• list_clientsread-only

  List clients from an organization.

• create_clientwrite · needs approval

  Create a new client. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_clientwrite · needs approval

  Delete a single client. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_clientread-only

  Retrieve a single client identified by its unique identifier.

• update_clientwrite · needs approval

  Update fields of a single client identified by its unique id. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_projectsread-only

  List projects from an organization.

• create_projectwrite · needs approval

  Create a new Project. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_projectwrite · needs approval

  Only projects at "draft" status can be deleted. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_projectread-only

  Retrieve a project by its unique identifier.

• update_projectwrite · needs approval

  Update an existing Project. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_project_servicesread-only

  List all services from a project identified by its unique id.

• create_project_servicewrite · needs approval

  Create a new Project Service on a project. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• approve_timesheetswrite · needs approval

  Approve once each timesheet referenced by their ID, and any timesheets before each of them pending approval belonging to the same timesheet owner. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• submit_timesheetswrite · needs approval

  Submit all timesheets for an owner up to the given period, or to the last submittable timesheet. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• approve_timesheetwrite · needs approval

  Approve once the timesheet referenced by its ID, and any timesheets before it pending approval belonging to the same timesheet owner. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• cancel_timesheetwrite · needs approval

  Cancel a timesheet referenced by its ID, and any timesheets after it pending approval belonging to the same timesheet owner. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• deny_timesheetwrite · needs approval

  Deny a timesheet with a mandatory comment. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• invalidate_timesheetwrite · needs approval

  Invalidate a timesheet with a mandatory comment. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• update_time_entries_v4write · needs approval

  ## Before using this service This service is aimed at updating a given user TimeEntries easily, as it automatically detects and applies changes needed to transform whatever TimeEntries might…. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_multiple_time_entrieswrite · needs approval

  Delete one or several time-entries. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• create_time_entrieswrite · needs approval

  Create one or multiple time-entries. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• update_multiple_time_entrieswrite · needs approval

  Update one or several time-entries. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• delete_time_entrywrite · needs approval

  Delete a time-entry. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• get_time_entryread-only

  Retrieve a single time-entry identified by its unique identifier.

• update_time_entrywrite · needs approval

  Update fields of a single time-entry identified by its unique id. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• list_due_timesheetsread-only

  List timesheets that are not yet submitted (status: 0).

• create_reportwrite · needs approval

  This endpoint does not adhere to the "v3 API endpoints" principles. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

• download_report_as_csvread-only

  This endpoint does not adhere to the "v3 API endpoints" principles.

• download_report_as_excelread-only

  This endpoint does not adhere to the "v3 API endpoints" principles.

• remind_timesheetswrite · needs approval

  Remind users of a due timesheet. Writes to Lucca, so it goes through the confirmation guardrail when enabled.

Example prompts

Just ask your AI in plain language — it picks the right Lucca API V3 tool:

• “List users from the directory. Optionally filter by email and include former employees — from Lucca API V3, in plain language.”
• “Get one user's details. Pass a comma-separated `fields` list to customize — from Lucca API V3, in plain language.”
• “List the organization's departments — from Lucca API V3, in plain language.”
• “List leave requests (Timmi Absences), pending or already decided — from Lucca API V3, in plain language.”

How it works

1. Create your Proxoria account and add your MCP endpoint to Claude or ChatGPT.
2. Connect Lucca API V3 with your API key — each user connects their own account, credentials encrypted at rest.
3. Your AI instantly gets the Lucca API V3 tools. Write actions wait for your approval in the dashboard before anything changes.

Frequently asked questions

Does Lucca API V3 have an official MCP server?

You don't need one. Proxoria exposes Lucca API V3 to your AI through the Model Context Protocol, so you can use it from Claude, ChatGPT, Mistral or any MCP-compatible client — no official Lucca API V3 MCP server required.

What can my AI do with Lucca API V3 through Proxoria?

It gets 134 tools: list_users, get_user, list_departments, list_leave_requests, list_leaves, decide_leave_request, list_expense_claims, list_timesheets, list_time_entries, list_user_locations, list_work_locations, create_user, update_user, list_expenseclaimitems, get_expenseclaimitem, create_expenseclaim, list_expensetempitems, create_temporary_expense, get_expensetempitem, update_expensetempitem, create_expense_accounting_export, list_work_contracts, get_work_contract, list_booked_documents, create_commitment_request, list_cost_centers, create_cost_center, get_cost_center, update_cost_center, delete_document, get_document, update_document, get_invoice, update_invoice, list_invoice_confirmations, confirm_invoice, list_natures, create_nature, get_nature, update_nature, list_purchases, create_purchase, get_purchase, close_purchase, create_commitment, cancel_commitment_request, list_suppliers, create_supplier, get_supplier, update_supplier, import_cost_centers, list_inbox_documents, update_inbox_document, book_inbox_document, list_vat_rates, list_department_tree, get_department, list_structure_departments, get_structure_department, list_establishments, list_legal_units, list_fixed_items, list_fixed_nature_categories, list_fixed_natures, get_fixed_nature, list_variable_items, create_variable_item, delete_variable_item, get_variable_item, update_variable_item, list_variable_nature_categories, list_variable_natures, get_variable_nature, list_realized_trainings, list_training_categories, list_training_providers, list_trainings, create_training, get_training, list_realized_trainings_v2, create_realized_training_v2, delete_realized_training_v2, get_realized_training_v2, list_training_demands, list_user_dates, list_workcycleexceptions, get_workcycleexception, list_employee_assignments, list_shiftoverrides, list_working_time_arrangements, get_working_time_arrangement, list_collective_schedules_from_a_working_time_arrangement, get_collective_schedule_from_a_working_time_arrangement, get_leave_request, get_leave, list_sickleavecertificates, get_sickleavecertificate, get_import_user_locations_analysis, get_import_user_locations_progress, get_import_user_locations_results, get_specific_userlocation, get_specific_worklocation, list_organizations, list_project_financials, list_clients, create_client, delete_client, get_client, update_client, list_projects, create_project, delete_project, get_project, update_project, list_project_services, create_project_service, approve_timesheets, submit_timesheets, approve_timesheet, cancel_timesheet, deny_timesheet, invalidate_timesheet, update_time_entries_v4, delete_multiple_time_entries, create_time_entries, update_multiple_time_entries, delete_time_entry, get_time_entry, update_time_entry, list_due_timesheets, create_report, download_report_as_csv, download_report_as_excel, remind_timesheets. For example, list users from the directory. optionally filter by email and include former employees.

Is the Lucca API V3 connector read-only?

No — it can also make changes. Write actions go through Proxoria's confirmation guardrail by default: your AI proposes them, and you approve each one from your dashboard before anything is written to Lucca API V3.

How do I connect Lucca API V3 to my AI?

Create a Proxoria account, connect Lucca API V3 with your API key, and add your Proxoria MCP endpoint to Claude or ChatGPT. Your AI instantly gains the Lucca API V3 tools.