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.

25 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_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.
get_attendance_reportGet an attendance report for all employees between `start_date` and `end_date` (YYYY-MM-DD).
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_sick_leave_caseGet one sick leave dossier by `sick_leave_dossier_id`, including its phases.
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_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.
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).

Set up in three steps

1
Pick the app
Create a free PipMCP 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 PipMCP 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?

PipMCP 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 PipMCP. You need the admin role to create a key.