Integration · Payroll & HR

Connect Claude & ChatGPT to Humanity

Ask your AI who is on shift right now, to create and publish next week's shifts, or to request leave for an employee in Humanity. It can read and manage employees, shifts, leave requests and timeclocks, clock people in and out, pull timesheet reports and send internal messages. Scheduling questions get answered without paging through the calendar.

Connect Humanity free

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

Try asking

“Who is working right now, and is anyone late?”
The AI lists who is on now and who is late for work.
“Create a shift for the Bar position on Saturday from 18 to 02 with two staff needed.”
It finds the position and creates the shift. It stays unpublished until you publish it.
“Publish next week's shifts and notify the staff.”
It lists the shifts for the week and publishes them with a notification to the employees.

What your AI can do

Shifts and schedules

List, create, update, publish and delete shifts, see who is on now, list positions and locations, and review shift trades.

Timeclock and timesheets

Clock employees in and out, read timeclock entries and pull timesheet summary, attendance and late reports.

Employees, leave and messages

Read, create and update employees, list and create leave requests, and read or send internal messages.

“Request vacation for Lisa from 1 to 5 July.”
It finds the vacation leave type and creates the leave request for Lisa for those dates.
“Give me a timesheet summary for last week.”
It pulls the timesheet summary report for that date range, per employee.
“Clock Jonas in now.”
It finds Jonas and clocks him in with the current time.

27 tools for Humanity

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 an employee in by `employee_id`, optionally at a given `clock_in_time` and `location`.
clock_outVisible to othersClock an employee out by `employee_id`, optionally at a given `clock_out_time`, with notes or tips.
create_employeeChanges dataAdd an employee: in `body` pass name (or fname and lname), email, and optionally positions, group (5 = Employee, 2 = Manager), wage and address; set `send_activation` to email them an invite.
create_leave_requestChanges dataRequest leave for an `employee`: `leavetype` ID, `start_date` and `end_date`, and for hourly leave set `is_hourly` with `start_time` and `end_time`.
create_shiftChanges dataCreate a shift: `schedule` (position ID), `start_date`, `start_time`, `end_date`, `end_time`, with optional `employee_id` list, title, notes and how many staff are `needed`. It stays unpublished until you publish it.
delete_shiftDeletesPermanently delete a shift by `shift_id`. This cannot be undone.
get_companyGet the company's Humanity account details.
get_current_userGet the Humanity employee the connection signs in as, including employee ID and permissions.
get_employeeGet one employee by `employee_id`, including contact details, positions, skills and wage.
get_leave_requestGet one leave request by `leaf_id` (the leave ID).
get_shiftGet one shift by `shift_id`, including time, position and assigned employees.
get_timeclockGet one timeclock entry by `timeclock_id`, including clock in and out times and breaks.
get_timesheet_reportGet a timesheet report between `start_date` and `end_date`; `type` is timesheetssummary, timesheetsattendance or timesheetslatesummary. Filter by `employee` IDs, `schedule` IDs or `approval_status`.
list_employeesList employees, optionally including `disabled` or `inactive` ones, or only those in a `location` or `schedule` (position). Use this to get an employee ID.
list_leave_requestsList leave requests, optionally by `user_id`, date range, `location` or `position`, with paging.
list_leave_typesList the leave types (vacation, sick and so on). A leave type ID is needed to request leave.
list_locationsList the company's locations and remote sites.
list_messagesList messages in your Humanity inbox, with `limit` and `offset`.
list_on_nowList who is working right now, optionally only those `lateforwork`.
list_positionsList positions (schedules). A position ID is required when creating shifts.
list_shift_tradesList shift trade requests by `mode`: manage, requested or available.
list_shiftsList shifts between `start_date` and `end_date`, optionally for a `schedule` (position), `location` or `employees`, and by `mode` (e.g. open, overview, employee).
list_timeclocksList timeclock entries, filtered by `employee`, `schedule`, `status` and date range, with paging.
publish_shiftsVisible to othersPublish shifts by comma-separated `shifts` IDs so employees can see them; `notify` 0 sends nothing, 1 notifies employees, 2 notifies employees and managers, with an optional `message`.
send_messageVisible to othersSend an internal message with `subject` and `message` to a position (`group_receivers`) and an employee (`individual_receivers`); pass `conversation` to reply. Recipients are notified.
update_employeeChanges dataUpdate an employee by `employee_id`: in `body` change contact details, job title, wage, group, location or status. Only the fields you pass change.
update_shiftChanges dataUpdate a shift by `shift_id`: change times, position, notes, or `add`/`remove` employees. Only the fields you pass change.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose Humanity from the app list.
2
Paste your key
In Humanity go to Settings > API v2, give the application a name and click Save. No redirect URI is needed. Copy the App ID and App Secret, and enter them together with your Humanity username and password.
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 Humanity?

It can read your company, employees, positions, locations, shifts, shift trades, who is on now, leave types, leave requests, timeclocks, timesheet reports and messages. It can create and update employees, shifts and leave requests, publish shifts, clock employees in and out and send internal messages. It can also delete a shift if you switch that tool on.

Does the AI see my Humanity login details?

No. Your Humanity login details 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. Publishing shifts and sending messages notify employees, and deleting a shift is permanent. Those tools 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 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 Humanity account.

Why does Humanity need my username and password?

Humanity's API v2 signs in with an application's App ID and App Secret together with a Humanity user's username and password. PipMCP uses them to get an access token, and the AI works as that user, with that user's permissions.