Integration · Payroll & HR

Connect Claude & ChatGPT to HoorayHR

Ask your AI who is working today, what time off is pending, or how many hours a team logged last month in HoorayHR. It can read employees, contracts, teams, availability and public holidays, register time off, open and update sick leave cases, and approve or reject time-off requests and time entries.

Connect HoorayHR free

Free plan, no credit card. Takes about a minute.

Try asking

“Who is off today?”
The AI checks the date and lists who is working and who is off.
“Book 3 days of holiday for Emma from 14 to 16 October.”
It finds Emma's user id and the leave types, then registers the time off with start, end and type.
“Approve Lars's pending time-off request.”
It finds the request among the time-off records and changes its status to approved.

What your AI can do

Time off and holidays

List, register and approve or reject time off, check leave types and public holidays, and see who is working on any date.

Sick leave

Open sick leave cases, add phases from reported sick to recovered, and adjust phase start dates.

People and time tracking

Read employees, contracts, teams, entities and availability, list time entries, approve them and pull attendance reports.

“Register that Peter called in sick this morning.”
It opens a sick leave case for Peter with a reported sick phase starting today.
“Which time entries from last week are still waiting for approval?”
It lists time entries with status REQUEST in that date range, per employee.
“Give me an attendance report for September.”
It pulls the attendance report for all employees between the first and last day of September.

56 tools for HoorayHR

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

add_sick_leave_phaseChanges dataAdd a phase to a sick leave dossier: `sick_leave_dossier_id`, `status` (REPORTED_SICK, REPORTED_RECOVERY, RECOVERED), `start_date` and `percentage` sick; optional `expected_return` and `notes`.
create_documentChanges dataCreate a new document. API summary: Create a document.
create_external_leave_budgetChanges dataCreate a new external leave budget. Required: body. Search external leave budgets first to avoid duplicates. API summary: Create external leave budget.
create_external_leave_typeChanges dataCreate a new external leave type. Required: body. Search external leave types first to avoid duplicates. API summary: Create external leave type.
create_sick_leave_caseChanges dataOpen a new sick leave dossier for an employee by `user_id`, optionally with initial `phases`.
create_time_offChanges dataRegister time off for an employee: `user_id`, `start` and `end`, `time_off_type`, optional `leave_type_id` and `notes`. Check list_leave_types for valid leave types.
create_userChanges dataCreate a new user. Search users first to avoid duplicates. API summary: Create user.
delete_external_leave_budgetDeletesPermanently delete a external leave budget by external leave budget id. Destructive action; may require approval. API summary: Remove external leave budget.
delete_external_leave_budgetsMoves moneyPermanently delete a external leave budget. Financial or irreversible action; may require approval. API summary: Remove multiple external leave budgets.
delete_external_leave_typeDeletesPermanently delete a external leave type by external leave type id. Destructive action; may require approval. API summary: Remove external leave type.
delete_external_leave_typesMoves moneyPermanently delete a external leave type. Financial or irreversible action; may require approval. API summary: Remove multiple external leave types.
delete_sick_leave_dossierDeletesPermanently delete a sick leave dossier by sick leave dossier id. Destructive action; may require approval. API summary: Remove sick leave dossier.
delete_sick_leave_phaseDeletesPermanently delete a sick leave phase by sick leave phase id. Destructive action; may require approval. API summary: Remove sick leave phase.
delete_time_trackingDeletesPermanently delete a time tracking by time tracking id. Destructive action; may require approval. API summary: Delete a time entry.
delete_time_trackingsMoves moneyPermanently delete a time tracking. Financial or irreversible action; may require approval. API summary: Delete multiple time entries.
find_work_location_categoriesSearch categories. Use this to find existing categories before creating a new category. API summary: Find work location categories.
get_attendance_reportGet an attendance report for all employees between `start_date` and `end_date` (YYYY-MM-DD).
get_availabilityGet one availability by availability id. API summary: Get availability.
get_categoryGet one category by category id. API summary: Get document category.
get_contractGet one contract by `contract_id`, with its terms and dates.
get_employeeGet one employee by `user_id`, with profile and employment details.
get_employment_termGet one employment term by employment term id. API summary: Get employment term.
get_employment_term_assignmentGet one employment term assignment by employment term assignment id. API summary: Get a single employment term assignment.
get_external_leave_budgetGet one external leave budget by external leave budget id. API summary: Get external leave budget.
get_external_leave_typeGet one external leave type by external leave type id. API summary: Get external leave type.
get_labelGet one label by label id. API summary: Get label.
get_leave_typeGet one leave type by leave type id. API summary: Get leave type.
get_sick_leave_caseGet one sick leave dossier by `sick_leave_dossier_id`, including its phases.
get_sick_leave_phaseGet one sick leave phase by sick leave phase id. API summary: Get sick leave phase.
get_teams_informationGet one teams information by teams information id. API summary: Get teams information by userId.
get_time_entryGet one time-tracking entry by `time_tracking_id`, including its activities.
get_time_offGet one time-off record by `time_off_id`, with dates, type, status and notes.
list_availabilityList employees' availability (the days and hours they normally work).
list_contractsList employee contracts.
list_employeesList employees (users) in HoorayHR. Set `include_extra_fields` true for extra profile fields. Use to find an employee's user id.
list_employment_term_assignmentsList employment term assignments. API summary: Find employment term assignments.
list_employment_termsList employment terms. API summary: Find employment terms.
list_entitiesList the company's legal entities.
list_labelsList labels that can be attached to time off, sick leave and documents.
list_leave_typesList the leave types configured in the company. Use the id as `leave_type_id` when creating time off.
list_public_holidaysList public holidays between `date_gte` and `date_lte` (YYYY-MM-DD), optionally for one employee's `user_id`.
list_sick_leave_casesList sick leave dossiers (one per sickness case per employee).
list_sick_leave_phasesList sick leave phases (reported sick, partial recovery, recovered) across dossiers.
list_teamsList team information for employees.
list_time_entriesList time-tracking entries, filtered by `user_id`, `status` (NOT_LOGGED, CONCEPT, REQUEST, APPROVED, DENIED), `start_date` or `end_date`.
list_time_offList time-off requests and registrations, optionally filtered by `time_off_type` (HOLIDAY, LEAVE, OVERTIME_NONE, OVERTIME_PAYOUT, OVERTIME_TIME_OF).
list_working_todaySee who is working on a given `date` (YYYY-MM-DD) and who is off. Optionally include archived users or inactive employments.
search_categoriesSearch categories by type. Use this to find existing categories before creating a new category. API summary: Find document categories.
search_external_leave_budgetsSearch external leave budgets. Use this to find existing external leave budgets before creating a new external leave budget. API summary: Find external leave budgets.
search_external_leave_typesSearch external leave types. Use this to find existing external leave types before creating a new external leave type. API summary: Find external leave types.
search_time_zonesSearch time zones. Use this to find existing time zones before creating a new time zone. API summary: Find time zones.
update_external_leave_typeChanges dataUpdate an existing external leave type identified by external leave type id. Only the fields you pass are changed. API summary: Patch external leave type.
update_sick_leave_phaseChanges dataChange the `start_date` of a sick leave phase by `sick_leave_phase_id`.
update_time_entry_statusChanges dataSet the `status` of one time entry by `time_tracking_id`, e.g. APPROVED or DENIED.
update_time_off_statusChanges dataChange the `status` of a time-off record by `time_off_id` (for example approve or reject a request).
update_time_trackingsVisible to othersUpdate an existing time tracking. Only the fields you pass are changed. Has effects visible outside this system. API summary: Change the status of multiple time entries.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose HoorayHR from the app list.
2
Paste your key
Paste a personal API key. You need the admin role in HoorayHR. Open Settings › API Keys, click New API Key, give it a name, an expiration date and only the scopes you want the AI to have. Copy the key right away (it starts with pk_). HoorayHR shows it only once.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in HoorayHR?

It can read employees, contracts, teams, legal entities, availability, labels, leave types, public holidays, time off, sick leave cases and time entries, and pull attendance reports. It can register time off, open sick leave cases and add or adjust phases, and change the status of time-off records and time entries.

Does the AI see my HoorayHR API key?

No. Your HoorayHR API key is encrypted at rest and never shown to the AI. After you save it, it is not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start read-only. Approving or rejecting time off, changing time entries and editing sick leave can each require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own HoorayHR account.

Can I limit what the API key gives access to?

Yes. When you create the key in HoorayHR under Settings › API Keys, you pick its scopes and an expiration date. HoorayHR then only allows what those scopes cover, on top of the tools you switch on in HeyMyApps. You need the admin role to create a key.