Integration · Projects & tasks

Connect Claude & ChatGPT to Hubstaff

Ask your AI how many hours someone worked, who is tracking time right now, or which timesheets are waiting for approval in Hubstaff. It can read tracked time, activity, timesheets, time off and manual time requests. It can also add manual time, approve or deny timesheets and requests, and create and update projects, clients and to-dos.

Connect Hubstaff free

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

Try asking

“How many hours did Sara work last week, per day?”
The AI finds Sara's user ID and lists her tracked time per day for the week, per project if you ask.
“Who is working right now, and on what?”
It lists each member's most recent tracked activity, with the project they are on.
“Which timesheets are submitted and waiting for approval?”
It lists timesheets with status submitted for the period. It can approve or deny them if you ask, and approval can affect payroll.

What your AI can do

Time and activity

Read tracked time per member per day, activity slots with activity levels, and who is working now.

Timesheets and requests

List timesheets, manual time requests and time off, approve or deny them, and add manual time.

Projects, clients and to-dos

Create and update projects, clients and to-dos, and read members, teams and client invoices.

“Add 2 hours to the Website project for me yesterday at 9:00, note: client call.”
It finds your user ID and the project and adds a manual time entry with the start time, tracked time and note.
“Create a to-do in the Launch project: update the pricing page, assigned to Jonas.”
It finds the project and Jonas's user ID and creates the to-do with him as assignee.
“Are there pending manual time requests this week?”
It lists manual time requests by status and date, and can approve or deny one. A denial needs a reason.

180 tools for Hubstaff

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

add_time_entryChanges dataAdd manual time for a user: `user_id`, `project_id`, `start_time` (ISO 8601), `tracked` seconds and usually a `note`, optionally a `task_id`.
archive_overtime_policyVisible to othersArchive a overtime policy (overtime policy id). Has effects visible outside this system. API summary: Archive overtime policy.
archive_time_off_policyVisible to othersArchive a time off policy (time off policy id). Has effects visible outside this system. API summary: Archive time off policy.
create_addressChanges dataCreate a new address. Required: name or location type. API summary: Create network location.
create_bulkVisible to othersCreate a new bulk. Required: invites. Has effects visible outside this system. API summary: Bulk invite users.
create_clientChanges dataCreate a client with a `name`, and optionally emails, phone, address, net terms and linked `project_ids`.
create_companyChanges dataCreate a new company. Required: name. API summary: Create organization.
create_company_attendance_scheduleChanges dataCreate a new attendance schedule for a company. Required: user id, start date, start time, duration, minimum time or use time zone. API summary: Create attendance schedule.
create_company_inviteChanges dataCreate a new invite for a company. Required: email. Search invites first to avoid duplicates. API summary: Create invite.
create_company_invite_linkVisible to othersCreate a new invite link for a company. Required: name. Has effects visible outside this system. API summary: Create invite link.
create_company_overtime_policyChanges dataCreate a new overtime policy for a company. Required: name, threshold, pay rate multiplier or user ids. API summary: Create overtime policy.
create_company_projectChanges dataCreate a new project for a company. Required: name, address, latitude, longitude, radius or rules. API summary: Create job site.
create_company_taskChanges dataCreate a new task for a company. Required: name or project ids. API summary: Create global to-do.
create_company_teamChanges dataCreate a new team for a company. Required: name. API summary: Create team.
create_company_time_off_balanceChanges dataCreate a new time off balance for a company. Required: reason or balance adjustments. Search time off balances first to avoid duplicates. API summary: Add organization time off balance adjustments.
create_company_time_off_policyChanges dataCreate a new time off policy for a company. Required: name, accrual type, allow negative balances, requires approval, balance rolls over annually or paid. API summary: Create time off policy.
create_company_time_off_requestChanges dataCreate a new time off request for a company. Required: user id, time off policy id, starts at, stops at, message or time off request days. API summary: Create time off request.
create_company_userChanges dataCreate a new user for a company. Required: user. Search users first to avoid duplicates. API summary: Create organization member.
create_company_webhookDeletesCreate a new webhook for a company. Required: events or target url. Destructive action; may require approval. API summary: Create organization webhook.
create_projectChanges dataCreate a project with a `name`, and optionally members, client, billable setting and budget.
create_project_rulesChanges dataCreate a new project. Required: rules. API summary: Add job site rules.
create_project_userChanges dataCreate a new user for a project. Required: type or member ids. Search users first to avoid duplicates. API summary: Create project member limit.
create_project_webhookDeletesCreate a new project for a project. Required: events or target url. Destructive action; may require approval. API summary: Create project webhook.
create_smart_notification_ruleChanges dataCreate a new smart notification rule. Required: name, frequency, metric type, condition, condition value or target. API summary: Create smart notification rule.
create_todoChanges dataCreate a to-do in a project: `project_id`, `summary` and optionally `assignee_ids`.
create_userDeletesCreate a new user. Required: events or target url. Search users first to avoid duplicates. Destructive action; may require approval. API summary: Create me webhook.
delete_addressDeletesPermanently delete a address by location id. Destructive action; may require approval. API summary: Delete network location.
delete_company_taskDeletesPermanently delete a task by task id. Destructive action; may require approval. API summary: Delete global to-do.
delete_inviteDeletesPermanently delete a invite by invite id. Destructive action; may require approval. API summary: Delete invite.
delete_invite_linkDeletesPermanently delete a invite link by invite link id. Destructive action; may require approval. API summary: Delete invite link.
delete_project_rulesDeletesPermanently delete a project by job site id. Destructive action; may require approval. API summary: Remove job site rules.
delete_project_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete project member limit.
delete_smart_notification_ruleDeletesPermanently delete a smart notification rule by rule id. Destructive action; may require approval. API summary: Delete smart notification rule.
delete_time_off_policyDeletesPermanently delete a time off policy by time off policy id. Destructive action; may require approval. API summary: Delete time off policy.
delete_time_off_requestDeletesPermanently delete a time off request by time off request id. Destructive action; may require approval. API summary: Delete time off request.
delete_todoDeletesPermanently delete a to-do by `task_id`. This cannot be undone.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete team.
delete_webhookDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete webhook.
get_addressGet one address by location id. API summary: Get network location.
get_budget_historyGet one budget history by budget history id. API summary: Get budget history.
get_clientGet one client by ID, including contact details, invoice settings and linked projects.
get_companyGet one company by company id. API summary: Get organization.
get_company_screenshotGet one screenshot for a company by screenshot id. API summary: Get screenshot.
get_company_status_statesGet the current status of a company by organization id. API summary: List organization tracking states.
get_current_userGet the Hubstaff user this connection acts as (name, email, time zone). Use to find your own user ID.
get_inviteGet one invite by invite id. API summary: Get invite.
get_invite_linkGet one invite link by invite link id. API summary: Get invite link.
get_limit_historyGet one limit history by limit history id. API summary: Get limit history.
get_manual_time_requestGet one manual time request by manual time request id. API summary: Get manual time request.
get_messageGet one message by message id. API summary: Get note.
get_overtime_policyGet one overtime policy by overtime policy id. API summary: Get overtime policy.
get_paymentGet one payment by payment id. API summary: Get team payment.
get_projectGet one project by `project_id`, including status, billable setting and budget.
get_project_2Get one project by project id. API summary: Get job site.
get_project_screenshotGet one screenshot for a project by screenshot id. API summary: Get screenshot.
get_project_userGet one user for a project by user id. API summary: Get member limit.
get_smart_notification_ruleGet one smart notification rule by rule id. API summary: Get smart notification rule.
get_time_off_policyGet one time off policy by time off policy id. API summary: Get time off policy.
get_time_off_requestGet one time off request by time off request id. API summary: Get time off request.
get_time_off_request_statusChanges dataGet the current status of a time off request by time off request id. API summary: Update time off request status.
get_todoGet one to-do by `task_id`, including assignees, status and its current `lock_version` (needed to update it).
get_userGet one user by `user_id`: name, email and time zone.
get_user_2Get one user by user id. API summary: Get team.
get_webhookGet one user by user id. API summary: Get webhook.
list_activitiesList tracked time slots (activities) between `time_slot_start` and `time_slot_stop`, optionally filtered by `user_ids` or `project_ids`. Includes activity levels.
list_addressesList addresses. Optional filters: page start id, page limit or location type. API summary: List network locations.
list_categoriesList categories. API summary: List tool categories.
list_client_invoicesList client invoices, filtered by `status`, `client_ids` or issue date range.
list_clientsList clients in the organization, optionally filtered by `status`.
list_company_addressesList addresses for a company. Optional filters: page start id, page limit, time slot start or time slot stop. API summary: List organization locations.
list_company_app_and_url_tracking_settingsList app and url tracking settings for a company. Optional filters: page start id, page limit or user ids. API summary: List member Track Apps & URLs settings.
list_company_attendance_schedulesList attendance schedules for a company. Optional filters: page start id, page limit, date start or date stop. API summary: List organization attendance schedules.
list_company_attendance_shiftsList attendance shifts for a company. Optional filters: page start id, page limit, date start or date stop. API summary: List organization attendance shifts.
list_company_budget_historiesList budget histories for a company. Optional filters: page start id, page limit, project ids, client ids, resource or start date start. API summary: List organization budget histories.
list_company_holidaysList holidays for a company. Optional filters: page start id, page limit, created start, created stop, date start or date stop. API summary: List organization holidays.
list_company_integrationsList integrations for a company. Optional filters: page start id or page limit. API summary: List organization integrations.
list_company_invite_linksList invite links for a company. Optional filters: page start id or page limit. API summary: List organization invite links.
list_company_job_site_visitsList job site visits for a company. Optional filters: page start id, page limit, user ids, enter start or enter stop. API summary: List organization job site visits.
list_company_job_typesList job types for a company.
list_company_limit_historiesList limit histories for a company. Optional filters: page start id, page limit, user ids, date start or limit type. API summary: List organization limit histories.
list_company_messagesList messages for a company. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or task ids. API summary: List organization notes.
list_company_overtime_policiesList overtime policies for a company. Optional filters: page start id, page limit or status. API summary: List organization overtime policies.
list_company_pagesList pages for a company. Optional filters: page start id, page limit, created start, created stop, event action or record type. API summary: List organization audit log entries.
list_company_passive_job_site_visitsList passive job site visits for a company. Optional filters: page start id, page limit, user ids, enter start or enter stop. API summary: List organization passive job site visits.
list_company_paymentsList payments for a company. Optional filters: page start id, page limit, created start, created stop, user ids or project ids. API summary: List organization team payments.
list_company_projectsList projects for a company. Optional filters: page start id, page limit, created start or created stop. API summary: List organization job sites.
list_company_ratesList rates for a company. Optional filters: user ids, kind, rate type, status, start date or end date. API summary: List organization rates.
list_company_screenshot_settingsList screenshot settings for a company. Optional filters: page start id, page limit or user ids. API summary: List member screenshot frequency settings.
list_company_screenshotsList screenshots for a company. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or project ids. API summary: List organization screenshots.
list_company_seatsList seats for a company. API summary: Get organization seats.
list_company_time_edit_logsList time edit logs for a company. Optional filters: page start id, page limit, created start, created stop, user ids or task ids. API summary: List organization time edit logs.
list_company_time_off_policiesList time off policies for a company. Optional filters: page start id, page limit or status. API summary: List organization time off policies.
list_company_tool_usagesList tool usages for a company. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or task ids. API summary: List organization tool usages.
list_customer_budget_historiesList budget histories for a customer. Optional filters: page start id or page limit. API summary: List client budget histories.
list_daily_activitiesList tracked time per member per day between `date_start` and `date_stop`, optionally filtered by `user_ids` or `project_ids`. Use for 'how many hours did X work' questions.
list_error_codesList error codes. API summary: List all error codes.
list_focus_timesList focus times. Optional filters: date start, date stop, user ids, project ids, team ids or remote vs office. Results are paginated.
list_idle_timesList idle times. Optional filters: date start, date stop, user ids, project ids, team ids or remote vs office. Results are paginated.
list_ignored_user_matchesList ignored user matches. Optional filters: page start id, page limit or pattern id.
list_ignored_user_patternsList ignored user patterns. Optional filters: page start id or page limit.
list_integration_project_linksList project links for a integration. Optional filters: page start id or page limit. API summary: List integration integration project links.
list_integration_tasksList tasks for a integration. Optional filters: page start id, page limit, status, user ids, project ids or remote ids. API summary: List integration tasks.
list_integration_user_linksList user links for a integration. Optional filters: page start id or page limit. API summary: List integration integration user links.
list_last_activitiesList each member's most recent tracked activity, showing who is working now and on which project.
list_manual_time_requestsList manual time requests, filtered by `status`, `user_ids`, `project_ids` or date range.
list_meetingsList meetings. Optional filters: date start, date stop, user ids, team ids, remote vs office or time zone. Results are paginated.
list_membersList members of the organization, optionally searching by `search_name` or `search_email` or filtering by `user_ids`. Use to find a member's user ID.
list_organization_daily_activities_updatesList updates. Optional filters: updated start, updated stop, page start id, page limit, user ids or task ids. API summary: List organization daily activities updates.
list_organization_daily_tool_usagesList dailies. Optional filters: page start id, page limit, date start, date stop, user ids or task ids. API summary: List organization daily tool usages.
list_organization_global_todosList tasks for a company. Optional filters: page start id or page limit. API summary: List organization global todos.
list_organization_team_invoicesList invoices for a company. Optional filters: page start id, page limit, user ids, issue date start, issue date stop or status. API summary: List organization team invoices.
list_organization_work_break_projectsList projects for a company. Optional filters: page start id, page limit or project ids. API summary: List organization work break projects.
list_organizationsList the Hubstaff organizations this connection can access, with their IDs and names.
list_project_activities_updatesList updates. Optional filters: page start id, page limit, updated start, updated stop, user ids or task ids. API summary: List project activities updates.
list_project_addressesList addresses for a project. Optional filters: page start id, page limit, time slot start or time slot stop. API summary: List project locations.
list_project_budget_historiesList budget histories for a project. Optional filters: page start id or page limit. API summary: List project budget histories.
list_project_daily_activitiesList dailies. Optional filters: page start id, page limit, date start, date stop, user ids or task ids. API summary: List project daily activities.
list_project_daily_activities_updatesList updates. Optional filters: updated start, updated stop, page start id, page limit, user ids or task ids. API summary: List project daily activities updates.
list_project_daily_tool_usagesList dailies. Optional filters: page start id, page limit, date start, date stop, user ids or task ids. API summary: List project daily tool usages.
list_project_integration_linksList integration links for a project. Optional filters: page start id or page limit. API summary: List project integration project links.
list_project_last_activitiesList tasks for a project. Optional filters: page start id, page limit or include removed. API summary: List project last activities.
list_project_messagesList messages for a project. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or task ids. API summary: List project notes.
list_project_screenshotsList screenshots for a project. Optional filters: page start id, page limit, time slot start, time slot stop or user ids. API summary: List project screenshots.
list_project_tasksList tasks for a project. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or task ids. API summary: List project activities.
list_project_tasks_get_v2_projects_project_id_tasksList tasks for a project. Optional filters: page start id, page limit, status, user ids, global todo ids or only global todos. API summary: List project tasks.
list_project_time_edit_logsList time edit logs for a project. Optional filters: page start id, page limit, created start, created stop, user ids or task ids. API summary: List project time edit logs.
list_project_tool_usagesList tool usages for a project. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or task ids. API summary: List project tool usages.
list_project_usersList users for a project. Optional filters: page start id or page limit. API summary: List project member limits.
list_projectsList projects in the organization, optionally filtered by `status` (active or archived) or `project_ids`.
list_smart_notification_rulesList smart notification rules. Optional filters: page start id or page limit.
list_smart_notificationsList smart notifications. Optional filters: page start id, page limit, user ids, team ids, created start or created stop.
list_tasksList tasks. Optional filters: date start, date stop, user ids, project ids, team ids or remote vs office. Results are paginated. API summary: List activity.
list_team_membersList the members of one team by `team_id`.
list_teamsList teams in the organization with their IDs and names.
list_time_off_requestsList time off requests, filtered by `user_ids` and start or creation date ranges.
list_timesheetsList timesheets, filtered by `status` (open, submitted, approved, denied) and a `date_start`/`date_stop` period.
list_todosList to-dos across the organization, filtered by `project_ids`, `user_ids` or `status` (active, completed).
list_unusual_activitiesList tasks. Optional filters: page start id, page limit, time slot start, time slot stop, user ids or include secondary activities. API summary: List unusual activities.
list_updatesList updates. Optional filters: page start id, page limit, updated start, updated stop, user ids or task ids. API summary: List organization activities updates.
list_user_policiesList user policies. Optional filters: user id, page start id or page limit. API summary: List organization time off policies per user.
list_user_projectsList projects for a user. Optional filters: page start id or page limit. API summary: List team projects.
list_work_time_classificationsList work time classifications. Optional filters: date start, date stop, user ids, project ids, team ids or remote vs office. Results are paginated.
restore_overtime_policyChanges dataRestore a overtime policy (overtime policy id). API summary: Restore overtime policy.
restore_time_off_policyChanges dataRestore a time off policy (time off policy id). API summary: Restore time off policy.
review_manual_time_requestChanges dataApprove or deny a manual time request by `manual_time_request_id` with `status`; `denial_reason` is required when denying.
search_company_invitesSearch invites for a company by page start id, page limit, email or status. Use this to find existing invites before creating a new invite. API summary: List organization invites.
search_company_time_off_balancesSearch time off balances for a company by page start id, page limit, search, user ids, time off policy ids or year. Use this to find existing time off balances before creating a new time off balance. API summary: List organization time off balances.
search_project_usersSearch users for a project by page start id, page limit, search email, search name, include removed or include profile. Use this to find existing users before creating a new user. API summary: List project members.
search_tool_classificationsSearch tool classifications by page start id, page limit, tool type, name, job type or productivity. Use this to find existing tool classifications before creating a new tool classification. API summary: List tool classifications.
submit_userDeletesActivate a user (webhook id). Destructive action; may require approval. API summary: Activate webhook.
update_addressChanges dataUpdate an existing address identified by location id. Only the fields you pass are changed. API summary: Update network location.
update_attendance_scheduleChanges dataUpdate an existing attendance schedule identified by attendance schedule id. API summary: Update attendance schedule.
update_clientChanges dataUpdate a client by ID: name, emails, phone, address, status, net terms or linked projects. Only the fields you pass change.
update_company_app_and_url_tracking_settingsVisible to othersUpdate an existing app and url tracking setting identified by organization id. Has effects visible outside this system. API summary: Update member Track Apps & URLs settings.
update_company_membersChanges dataUpdate an existing company identified by organization id. API summary: Update organization members.
update_company_metadataChanges dataUpdate an existing company identified by organization id. API summary: Update organization metadata.
update_company_screenshot_settingsVisible to othersUpdate an existing screenshot setting identified by organization id. Has effects visible outside this system. API summary: Update member screenshot frequency settings.
update_company_taskChanges dataUpdate an existing task identified by task id. API summary: Update global to-do.
update_customer_metadataChanges dataUpdate an existing customer identified by client id. API summary: Update client metadata.
update_inviteVisible to othersUpdate an existing invite identified by invite id. Has effects visible outside this system. API summary: Update invite.
update_invite_linkVisible to othersUpdate an existing invite link identified by invite link id. Has effects visible outside this system. API summary: Update invite link.
update_overtime_policyChanges dataUpdate an existing overtime policy identified by overtime policy id. API summary: Update overtime policy.
update_projectChanges dataUpdate a project by `project_id`: name, status, billable setting, rates or budget. Only the fields you pass change.
update_project_2Changes dataUpdate an existing project identified by project id. API summary: Update job site.
update_project_membersChanges dataUpdate an existing project identified by project id. API summary: Update project members.
update_project_metadataChanges dataUpdate an existing project identified by project id. API summary: Update project metadata.
update_project_rulesChanges dataUpdate an existing project identified by job site id. API summary: Update job site rules.
update_project_userChanges dataUpdate an existing user identified by user id. API summary: Update project member limit.
update_smart_notification_ruleChanges dataUpdate an existing smart notification rule identified by rule id. API summary: Update smart notification rule.
update_smart_notification_rule_toggle_statusesVisible to othersUpdate an existing toggle status identified by rule id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Toggle smart notification rule.
update_task_metadataChanges dataUpdate an existing task identified by task id. API summary: Update task metadata.
update_time_off_policyChanges dataUpdate an existing time off policy identified by time off policy id. API summary: Update time off policy.
update_time_off_requestChanges dataUpdate an existing time off request identified by time off request id. API summary: Update time off request.
update_timesheet_statusChanges dataApprove, deny, submit or reopen a timesheet by `timesheet_id` via `status`; give a `denial_reason` when denying. Approval can affect payroll.
update_todoChanges dataUpdate a to-do by `task_id`: summary, assignees or `status` (active or completed). Requires the current `lock_version` from get_todo.
update_tool_classificationsVisible to othersUpdate an existing tool classification identified by organization id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update tool classifications.
update_userChanges dataUpdate an existing user identified by user id. API summary: Update team.
update_user_membersChanges dataUpdate an existing user identified by team id. API summary: Update team members.
update_user_metadataChanges dataUpdate an existing user identified by team id. API summary: Update team metadata.
update_user_projectsChanges dataUpdate an existing user identified by team id. API summary: Update team projects.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Hubstaff from the app list.
2
Paste your key
Paste two values: an organization access token (it starts with hsoat_) and your Hubstaff organization ID. In the Hubstaff web app, an owner, manager or Manage-IT member goes to Settings > Organization > API tokens, creates a token and assigns it to a member. The token acts with that member's access. Copy it right away, 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 Hubstaff?

The AI can read members, teams, projects, clients, to-dos, tracked time, activities, timesheets, time off requests, manual time requests and client invoices. It can create and update projects, clients and to-dos, add manual time, approve or deny timesheets and manual time requests, and delete to-dos if you switch those tools on.

Does the AI see my Hubstaff credentials?

No. Your Hubstaff credentials 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. Approving a timesheet can affect payroll and deleting a to-do cannot be undone, and actions like these 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 Hubstaff account.

Whose access does the AI get in Hubstaff?

The access of the member the organization token is assigned to. When you create the token under Settings > Organization > API tokens, you assign it to a member, and every call acts with that member's access. Assign it to a member whose access matches what you want the AI to see and change.