Integration · Payroll & HR

Connect Claude & ChatGPT to ClayHR

Ask your AI who is off next week, which leave requests are waiting for you, or to log three hours on a project in ClayHR. It can search and update employees, clock you in and out, save time entries, approve or reject timesheets and add job candidates. It also reads goals, performance reviews, positions, org units and expense reports.

Connect ClayHR free

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

Try asking

“Who is off between 14 and 18 October?”
The AI lists who is on leave from the start date to the end date you give.
“Which leave requests are waiting for me?”
It lists the leave requests waiting for your approval or rejection.
“Log 3 billable hours on the Website project for today.”
It finds the project and saves a time entry with the date, elapsed time and billable set to Y.

What your AI can do

Employees and organisation

Search, read, create and update employees, and list positions, org units and projects.

Time off and timesheets

See who is off, request leave, clock in and out, save time entries and approve or reject timesheets.

Hiring, goals and expenses

Add and search candidates, list goals and performance reviews, and list or create expense reports.

“Approve Maria's timesheet for last week.”
It finds the timesheet among those awaiting approval and sets its status to approved, with a comment if you add one.
“Add Jonas Berg as a candidate, [email protected], source LinkedIn.”
It creates the candidate with name, email and source.
“Request time off for me from 2 to 6 December.”
It looks up your PTO policies and creates a leave request for those dates under the policy you pick.

125 tools for ClayHR

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

clock_inChanges dataClock the connected user in now, optionally for a `project_id` with `notes` or `description`.
clock_outChanges dataClock the connected user out now, optionally with `notes`.
create_a_new_leaveChanges dataCreate a new add. API summary: Create a new leave.
create_a_new_skillChanges dataCreate a new add. Required: description or skill code. API summary: Create a new skill.
create_a_survey_response_by_assignment_idChanges dataCreate a new save. Required: assignment id. API summary: Create a survey response by assignment id.
create_addChanges dataCreate a new add. Required: body. API summary: Add PTO balance.
create_allocationChanges dataCreate a new allocation. Required: project id or user id. API summary: Allocate Project.
create_bulk_launchVisible to othersCreate a new bulk launch. Has effects visible outside this system. API summary: Launch Performance Reviews In Bulk.
create_candidateChanges dataAdd a job candidate with `name`, `email`, `phone` and `source`.
create_compensation_for_userChanges dataCreate a new add. Required: value, compensation type, user id, currency code, period or effectivedate. API summary: Create compensation for user.
create_createChanges dataCreate a new create. Required: title or description. API summary: Create Announcement.
create_editChanges dataCreate a new edit. Required: amount, currency code, date, remarks, user id or expense item id. API summary: Edit expense item.
create_employeeChanges dataCreate a new employee user with `email` and `first_name`.
create_expense_reportChanges dataCreate an expense report with a `name`, optional `amount` and `description`.
create_expenseitemChanges dataCreate a new expenseitem. Required: amount, currency code, date, remarks, user id or expense item id. API summary: Create expense item.
create_goalChanges dataCreate a new goal.
create_leave_requestChanges dataRequest time off: pass `date` (start), `leave_end_date`, `user_pto_id` (the PTO policy) and an optional `description`.
create_new_org_unitChanges dataCreate a new add. Required: name or description. API summary: Create new org unit.
create_performance_reviewChanges dataCreate a new add. Required: user id or template id. API summary: Create Performance Review.
create_projectChanges dataCreate a new project. Required: project name, project desc, short code or start date. API summary: Create Project.
create_resumeChanges dataCreate a new resume. Required: file. API summary: Create a candidate from pdf resume.
create_saveChanges dataCreate a new save. Required: name, count, status, access level, date open or date close. API summary: Save Position.
create_save_save_shift_using_postChanges dataCreate a new save. Required: body. API summary: Save Shift.
create_save_save_user_addressesChanges dataCreate a new save. Required: user id. API summary: Save User Address.
create_save_save_user_educationsChanges dataCreate a new save. Required: user id. API summary: Save User Education.
create_save_save_user_employmentsChanges dataCreate a new save. Required: user id. API summary: Save User Employment.
create_the_item_s_response_for_a_surveyChanges dataCreate a new save. Required: assignment id, item id or response value. API summary: Create the item's response for a survey.
create_updateChanges dataCreate a new update. Required: guid, value, compensation type, user id, currency code or period. API summary: Update financial record of User.
delete_a_timesheetDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete a timesheet.
delete_deletesDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete dependent by contact ID.
delete_deletes_deletes_user_employment_detailsDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Deletes User Employment.
delete_expense_itemDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete expense item.
delete_expense_reportDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete expense report.
delete_user_addressDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete User Address.
delete_user_educationDeletesPermanently delete a delete. Destructive action; may require approval. API summary: Delete User Education.
download_documentDownload the document for a document. API summary: Retrieve document as byte array.
get_a_list_of_surveysList lists. API summary: Get a list of surveys.
get_allocationGet one allocation by project id. API summary: List Allocations.
get_announcementGet one announcement by ann id. API summary: Retrieve Announcement.
get_appraisal_completed_reviewsGet one appraisal. API summary: Retrieve Completed Performance Reviews.
get_candidateGet one candidate's full details by the candidate's `recruitid`.
get_detailGet one detail by timecard id. API summary: Retrieve timecard details based on timecard ID.
get_documentGet one document by target user id. API summary: Fetch User Specific Attachments.
get_employeeGet one employee's details by `user_id`.
get_listGet one list by ann id. API summary: Retrieve Announcement Attachments.
get_projectGet one project by `project_id`.
get_pto_policies_by_user_idList ptopolicies. API summary: Get PTO policies by User Id.
get_responseGet one response by dynamic form id. API summary: Retrieve form response.
get_timesheetGet one timesheet by `timesheet_id`.
get_update_statusGet the current status of a update. API summary: Retrieve user financial status.
list_allactivesList allactives. API summary: Retrieve all active OrgRelations.
list_assignmentsList assignments. API summary: Retrieve Performance Review Assignments.
list_candidatesList candidates. API summary: Retrieve candidates.
list_contentsList contents. Optional filters: analytic id. API summary: Get content for report by analytic Id.
list_creditsList credits. Optional filters: leave date, leave id, leave user id or pto policy id. API summary: Get remaining hours credit for leave policy.
list_currencylistsList currencylists. API summary: Retrieve currencies.
list_customfieldsList customfields. Optional filters: object type. API summary: Get Custom Fields.
list_customgroupsList customgroups. Optional filters: object id or object type. API summary: Get Custom Groups by Object ID.
list_detailsList details. Optional filters: dynamic form id. API summary: Retrieve test details.
list_document_librariesList document libraries. API summary: Retrieve attachments within document library.
list_employee_goalsList the goals of one employee by `user_id`.
list_expense_reportsList expense reports, optionally for one `expense_report_id` or user `guid`.
list_expensetypesList expensetypes. API summary: Retrieve expense types.
list_getdynaformsList getdynaforms. API summary: Retrieve forms.
list_goalsList all goals.
list_invoicesList invoices. Optional filters: project id. API summary: Retrieve invoices by Project ID.
list_jobprofilesList jobprofiles. Optional filters: status. API summary: Retrieve job profiles.
list_leaves_for_approvalList leave requests waiting for the connected user's approval or rejection.
list_leaves_process_user_leave_by_id_using_getList leaves. Optional filters: leave id or status. API summary: Process the leave of a user by leave id.
list_listsList lists. API summary: Retrieve Performance Review Templates.
list_miesList mies. API summary: Retrieve completed forms assigned to me.
list_my_pto_policiesList the PTO (time-off) policies of the connected user.
list_objectivesList objectives. Optional filters: user id or objective id. API summary: Retrieve objectives.
list_org_unitsList the organisation units.
list_paystubsList paystubs. API summary: Retrieve my pay stubs.
list_performance_reviewsList performance reviews visible to the connected user.
list_permissionsList permissions. API summary: Retrieve user permissions and menu configurations.
list_positionsList positions, searchable with `search`. Paginated.
list_projectsList projects.
list_ptopoliciesList ptopolicies. API summary: Retrieve list of PTO policies.
list_reportsList reports. Optional filters: analytic id. API summary: Get report.
list_responselistsList responselists. Optional filters: dynamic form id or last assignment id. API summary: Retrieve form responses.
list_savesList saves. Optional filters: org relation id, user id, manager user id, manager email, user email or other user id. API summary: Saves the OrgRelation for the User.
list_shiftsList shifts. Optional filters: project id, user id, start date, end date or status. API summary: Get Shifts.
list_skillsList skills. API summary: Retrieve skills.
list_testsList tests. Optional filters: status. API summary: Retrieve the test by Status.
list_timecardsList timecards. Optional filters: start date or end date. API summary: Retrieve timecards by Timesheet ID.
list_timesheet_approvalsList timesheets awaiting approval between `start_date` and `end_date`.
list_timesheetsList timesheets, optionally for a `user_id` and between `start_date` and `end_date`.
list_trainingsList trainings. API summary: Retrieve my training assignments.
list_user_skillsList user skills. Optional filters: assigned user id. API summary: Retrieve skills assigned to a user.
list_viewsList views. Optional filters: positionid. API summary: Retrieve position.
list_views_get_dyna_form_details_using_getList views. Optional filters: dynamic form id. API summary: Get the details of a survey form by form id.
list_who_is_offList who else is on leave from `start_date` (to optional `end_date`).
retrieve_all_the_orgrelations_for_the_given_userSearch users by employee user id, emp id or email. Use this to find existing users before creating a new user. API summary: Retrieve all the OrgRelations for the given user.
retrieve_basic_user_detailsSearch basics by name, search, start date before, start date after, end date before or end date after. Use this to find existing basics before creating a new basic. Results are paginated. API summary: Retrieve basic user details.
retrieve_form_detailsList views. Optional filters: dynamic form id. API summary: Retrieve form details.
retrieve_list_of_activity_types_based_on_cidList lists. API summary: Retrieve list of activity types based on cid.
retrieve_list_of_assigned_testsList lists. API summary: Retrieve list of assigned tests.
retrieve_my_active_allocationsList lists. API summary: Retrieve my active allocations.
retrieve_my_timesheet_preferencesList lists. API summary: Retrieve my timesheet preferences.
retrieve_the_test_assignments_by_dynamicformidList lists. Optional filters: dynamic form id. API summary: Retrieve the test assignments by dynamicFormId.
retrieve_timecard_details_by_user_idSearch timecards by user id, email or guid. Use this to find existing timecards before creating a new timecard. API summary: Retrieve timecard details by User ID.
retrieve_timesheet_details_by_timesheet_idGet one detail by time sheet id. API summary: Retrieve timesheet details by Timesheet ID.
retrieve_training_content_by_training_idList contents. Optional filters: training id. API summary: Retrieve training content by training ID.
save_timesheet_entryChanges dataCreate or update a time entry: `date`, `project_id` and `elapsed_time` are required; add `user_id`, `activity`, `billable` (Y/N), `category_code` (RG regular, OT overtime) and `notes`. Pass `card_id` to update an existing entry.
search_basicsSearch basics by email or user id. Use this to find existing basics before creating a new basic. API summary: Retrieve user basic information.
search_candidatesSearch job candidates by `search` text. Paginated.
search_compensationSearch compensation by email or user id. Use this to find existing compensation before creating a new compensation. API summary: Retrieve user financial record.
search_employeesSearch employees by `name` or `search` text, filtered by `status` (A active, I inactive, F future joiner) or start/end date ranges. Paginated.
search_expensereportsSearch expensereports by user id, guid or email. Use this to find existing expensereports before creating a new expensereport. API summary: Retrieve expense reports.
search_leave_requestsSearch leave (time-off) requests between `start_date` and `end_date`, optionally filtered by employee `email` or `leave_userid` and `status`.
search_listsSearch lists by name, search, start date before, start date after, end date before or end date after. Use this to find existing lists before creating a new list. API summary: Retrieve a user or list of users.
search_resourcesSearch resources by name, sort by, sort order or status. Use this to find existing resources before creating a new resource. Results are paginated. API summary: Retrieve users.
search_timecardsSearch timecards by user id, email or guid. Use this to find existing timecards before creating a new timecard. API summary: Retrieve timecard basic details by User ID.
set_timesheet_statusChanges dataApprove, reject or change the status of a timesheet by `timesheet_id`: `status` is PD pending, PAP partially approved, AP approved, NEW or RJ rejected; add `comments`.
submit_submitVisible to othersSubmit a submit (expense report id). Has effects visible outside this system. API summary: Submit expense report.
submit_user_detailsVisible to othersComplete a user. Has effects visible outside this system. API summary: Create or Update user.
update_addChanges dataUpdate an existing add identified by list id. API summary: Add Custom List Entries.
update_editsVisible to othersUpdate an existing edit. Has effects visible outside this system. API summary: Update Announcement.
update_employeeChanges dataUpdate an employee by `user_id`: name, email, phone, position, location, status, start/end date and more. Only the fields you pass change.
update_form_responsesChanges dataUpdate an existing form response. API summary: Save form repsonse.
update_item_responsesChanges dataUpdate an existing item response. API summary: Save item response.
update_training_status_for_userChanges dataCreate a new update. Required: status or user training id. API summary: Update training status for user.
update_users_custom_field_valuesChanges dataUpdate an existing user. API summary: Save Custom Field values.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose ClayHR from the app list.
2
Paste your key
Enter your ClayHR subdomain (the "acme" in acme.clayhr.com), your numeric ClayHR user ID and an API key. In ClayHR, hover over your user record in the top right corner, click My Integrations, switch to Manage API Keys and click Generate API Key. Copy the key right away, because it is shown 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 ClayHR?

It can search and read employees, projects, positions, org units, timesheets, leave requests, goals, performance reviews, expense reports and candidates. It can create and update employees, request leave, clock in and out, save time entries, change a timesheet's status, create expense reports and add candidates.

Does the AI see my ClayHR credentials?

No. Your subdomain, user ID and API key are encrypted at rest and never shown to the AI. After you save them, they are 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. Changes like approving or rejecting a timesheet or updating an employee can 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 ClayHR account.

What access does the AI get in ClayHR?

The API key has the same access as the ClayHR user who generated it. The AI can only see and change what that user can, and only through the tools you switch on. Clocking in and out also applies to that user.