Integration · Payroll & HR

Connect Claude & ChatGPT to TimeKeeper

Ask your AI who is clocked in right now, what an employee's timesheet looks like, or how many hours went on a job this month. It reads employees, time entries, timesheets, job reports, shifts and leave from TimeKeeper, and can create and update jobs and activities. Payroll and job costing questions get answered without building a report by hand.

Connect TimeKeeper free

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

Try asking

“Who is clocked in right now?”
The AI shows everyone who is currently clocked in.
“Show Tom's timesheet for last week.”
It finds Tom's employee ID and reads his timesheet for that period.
“How much time went on the Riverside job this month?”
It finds the job and gets its time breakdown report for the dates you give.

What your AI can do

Time and timesheets

List time entries by employee, job or activity, read an employee's timesheet and see who is clocked in.

Jobs and activities

Get a job's time breakdown report, and list, create and update jobs and activities.

Shifts and leave

List scheduled and open shifts, leave requests by status and booked leave entries.

“Which leave requests are still open?”
It lists leave requests with status open for the period, with employee and leave type.
“Who is on shift tomorrow, and are there any open shifts?”
It lists scheduled shifts for that day, including open shifts that nobody has taken.
“Add a new job, Park Road refurbishment, job number 2045.”
It checks the job list for duplicates and creates the job with that name and number.

14 tools for TimeKeeper

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

create_activityChanges dataCreate an activity with `name` and an optional `activity_number`.
create_jobChanges dataCreate a job with `name`, and optionally `job_number` and `address` (with latitude/longitude). List jobs first to avoid duplicates.
get_employee_timesheetGet one employee's timesheet by `employee_id` for the period `start_date` to `end_date`.
get_job_breakdown_reportGet the time breakdown report for one job by `job_id` between `start_date` and `end_date`.
list_activitiesList activities (the kinds of work time is logged as) with their IDs.
list_employeesList employees in TimeKeeper with their IDs. Use to find an employee ID before other lookups.
list_jobsList jobs (the projects or sites time is tracked against) with their IDs.
list_leave_entriesList booked leave entries between optional `start_date` and `end_date`, filtered by `employee_id` or `leave_type_id`.
list_leave_requestsList leave requests between `start_date` and `end_date`, filtered by `status` (open, approved, denied, all), `employee_id` or `leave_type_id`.
list_shiftsList scheduled shifts between `start_date` and `end_date`, optionally for one `employee_id`, including drafts (`draft`) or open shifts (`show_open`).
list_time_entriesList time entries between `start_date` and `end_date`, optionally filtered by `employee_id`, `job_id` or `activity_id`. Results are paginated with `page`.
list_whos_inShow who is currently clocked in right now.
update_activityChanges dataUpdate an activity by `task_id` (the activity ID): pass `name` and optionally `activity_number`.
update_jobChanges dataUpdate a job by `project_id` (the job ID): pass `name` plus any of `job_number` or `address` to change.

Set up in three steps

1
Pick the app
Create a free PipMCP account and choose TimeKeeper from the app list.
2
Paste your key
Leave the username empty and paste your TimeKeeper API key as the password. Generate the key in TimeKeeper at app.timekeeper.co.uk/account/api-keys. The key has admin rights on your account, so keep it safe.
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 TimeKeeper?

It can list employees, jobs, activities, time entries, shifts, leave requests and leave entries, read an employee's timesheet, get a job's time breakdown report and show who is clocked in. It can also create and update jobs and activities.

Does the AI see my TimeKeeper API key?

No. Your TimeKeeper 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 keep it to reading time and leave data. Creating and updating jobs and activities can require your approval before it runs. There are no tools for deleting anything, and 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 TimeKeeper account.

Why do I leave the username empty?

TimeKeeper signs API requests in with the API key alone. You leave the username empty and paste the key as the password. The key has admin rights on your account, which is another reason to switch on only the tools you need.