Integration

Hubstaff integration

Hubstaff is time tracking and workforce management software. Read organizations, members, projects, tasks, clients and teams; pull tracked activity (10-minute blocks and daily totals), tool usage, GPS locations, attendance shifts, timesheets, notes, invoices, payments and Insights productivity reports; create and update projects, tasks, clients, teams, invites, job sites, attendance schedules, overtime and time off policies; approve or deny time off and manual time requests; add time entries. Many reads expose personal data (pay rates, payroll, GPS positions, IP addresses). Not exposed: screenshots and their settings, app and URL tracking settings, webhook subscriptions (they need an echo handshake), metadata editing, integration links, organization creation, Silent app patterns, and the rates, job types and tool categories lists (no documented response). Authentication is a Hubstaff organization access token (hsoat_..., created by an owner, manager or Manage-IT member under Settings, Organization, API tokens; it acts as the member it is assigned to and never needs refreshing) sent as a Bearer token. A personal access token cannot be pasted here: it is a refresh token that must be exchanged first.

Connect Hubstaff How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Hubstaff.Built from the 148 Hubstaff tools below, on the connection you add once.

What you can do with Hubstaff

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Task, 5 operations

create_taskCreate taskPOSTCreates a to-do in a project. On a project integrated with a third-party tool, create the task in that tool instead.
delete_taskDelete taskDELETEDeletes a task. Note: Only simple todos can be deleted. 3rd party tasks must be deleted in their system.
get_taskGet taskGETReturns the task with the given ID.
list_organization_tasksList organization tasksGETReturns a collection of tasks (to-dos) for the given organization. Results can be filtered by status[] (active/completed/deleted), user_ids[], project_ids[], and global_todo_ids[].
list_project_tasksList project tasksGETReturns a collection of tasks (to-dos) for the given project. Results can be filtered by status[] (active/completed/deleted), user_ids[], project_ids[], and global_todo_ids[].

Budget history, 4 operations

get_budget_historyGet budget historyGETReturns the budget history with the given ID.
list_client_budget_historiesList client budget historiesGETReturns budget configuration history (changes to budget settings over time) for the given client.
list_organization_budget_historiesList organization budget historiesGETReturns budget configuration history (changes to budget settings over time) for the given organization. The project_ids and client_ids filters are processed as a complete set.
list_project_budget_historiesList project budget historiesGETReturns budget configuration history (changes to budget settings over time) for the given project.

Daily, 4 operations

list_organization_daily_activitiesList organization daily activitiesGETLists daily tracked-time totals per member, project and task for the organization, by organization-timezone date. date range at most 31 days, earliest 3 years ago. Filter with user_ids, project_ids, task_ids.
list_organization_daily_tool_usagesList organization daily tool usagesGETLists daily time spent in apps and websites per member within date[start]/date[stop] (at most 14 days, earliest 1 month ago). Owner or manager with view-others-data permission.
list_project_daily_activitiesList project daily activitiesGETLists daily tracked-time totals per member and task for one project, by organization-timezone date. date range at most 31 days, earliest 3 years ago.
list_project_daily_tool_usagesList project daily tool usagesGETLists daily time spent in apps and websites per member on one project within date[start]/date[stop] (at most 14 days, earliest 1 month ago).

Invite, 4 operations

create_inviteCreate invitePOSTInvites a person by email to the organization with a role and optional projects; Hubstaff emails the invite, and an email that already has a Hubstaff account is accepted automatically. Invite creation is rate limited.
delete_inviteDelete inviteDELETEDeletes an invite. Note: Accepted invites cannot be deleted.
get_inviteGet inviteGETReturns the invite with the given ID.
list_invitesList invitesGETReturns a collection of invites for the given organization. Results can be filtered by email and status.

Invite link, 4 operations

create_invite_linkCreate invite linkPOSTCreates a shareable invite link: anyone holding its url can join the organization. At least one project or team is required. Owners and managers with the invite members permission.
delete_invite_linkDelete invite linkDELETEDeletes an invite link at once; members who already joined stay. The default invite link cannot be deleted. Only for owners and managers with the invite members permission.
get_invite_linkGet invite linkGETReturns the invite link with the given ID. Only available to organization owners and managers with the invite members permission.
list_invite_linksList invite linksGETLists the organization's invite links, including disabled and expired ones. Only for organization owners and managers with the invite members permission.

Member, 4 operations

create_organization_memberCreate organization memberPOSTCreates a new Hubstaff user and adds them to the organization with a role (organization_manager, project_manager, project_user, project_viewer) and an optional pay period. Returns the member.
list_organization_membersList organization membersGETLists the organization's members with role, status and pay and bill rates; include_profile adds profile fields (owners and managers only). Filter by search[email], search[name], user_ids, membership_roles. Contains personal data.
list_project_membersList project membersGETLists one project's members with project role (manager, user, viewer) and pay and bill rates. Filter by search, user_ids, membership roles and created_at/updated_at ranges. Contains personal data.
list_team_membersList team membersGETLists a team's members and their team role: manager (tracks time, sees all data, manages settings and members), user (tracks time, sees own data) or viewer (reports only).

Member limit, 4 operations

create_member_limitCreate member limitPOSTCreates a member budget limit group for the given project. All `member_ids` must already be project members. Users assigned to another group are moved to the new group.
delete_member_limitDelete member limitDELETEDeletes a member budget limit group for the given project. Assigned members are removed from the group. Project-level `alerts` settings are not changed.
get_member_limitGet member limitGETReturns the member budget limit group with the given ID. Requires organization owner or organization manager for the project's organization.
list_member_limitsList member limitsGETReturns paginated member budget limit groups for the given project. Requires organization owner or organization manager for the project's organization.

Network location, 4 operations

create_network_locationCreate network locationPOSTCreates an on_site network location (an office network, by IP range or MAC address) or a remote one. Needs the Owner or Organization Manager role and the Insights add-on.
delete_network_locationDelete network locationDELETEPermanently deletes a network location. Requires Owner or Organization Manager role. Requires the Insights add-on.
get_network_locationGet network locationGETReturns a single network location by ID. Requires Owner or Organization Manager role. Requires the Insights add-on.
list_network_locationsList network locationsGETLists the organization's network locations, which mark networks as on site (office) or remote for Insights. Needs the Owner or Organization Manager role and the Insights add-on.

Project, 4 operations

create_projectCreate projectPOSTCreates a new project. Returns the created project. Only name is required. Members can optionally be added with roles: viewer, user, or manager.
get_projectGet projectGETReturns the project with the given ID.
list_organization_projectsList organization projectsGETReturns a collection of projects for the given organization. Results can be filtered by status (active/archived/all) and project_ids[].
list_team_projectsList team projectsGETReturns a collection of projects for the given team.

Smart notification rule, 4 operations

create_smart_notification_ruleCreate smart notification rulePOSTCreates a smart notification rule (enabled on creation): metric, target (all_members, team_ids, user_ids), recipients (roles or user_ids, owners, managers, team leads only) and deliver_by (insights, email, slack).
delete_smart_notification_ruleDelete smart notification ruleDELETEDeletes a smart notification rule.
get_smart_notification_ruleGet smart notification ruleGETReturns the smart notification rule with the given ID.
list_smart_notification_rulesList smart notification rulesGETReturns a collection of smart notification rules for the given organization.

Team, 4 operations

create_teamCreate teamPOSTCreates a new team. Returns the created team. Only name is required. Members can optionally be added with roles: viewer, user, or manager.
delete_teamDelete teamDELETEDeletes a team. Note: SCIM-managed teams cannot be deleted.
get_teamGet teamGETReturns the team with the given ID.
list_teamsList teamsGETReturns a collection of teams for the given organization.

Time off policy, 4 operations

create_time_off_policyCreate time off policyPOSTCreates a new time off policy for the given organization.
delete_time_off_policyDelete time off policyDELETEDeletes a time off policy. Refused when a member has paid or approved requests or used hours; use archive_time_off_policy for a policy that has been used.
get_time_off_policyGet time off policyGETReturns the time off policy with the given ID. Callers without an organization management role can only access policies they are an active member of. Other policies return 404.
list_time_off_policiesList time off policiesGETReturns a collection of time off policies for the given organization. Callers without an organization management role see only the policies they are an active member of.

Time off request, 4 operations

create_time_off_requestCreate time off requestPOSTCreates a time off request for a member. time_off_request_days needs one entry per date from starts_at to stops_at (amount_used in seconds, 0 for excluded days). Times are wall-clock in the member's time zone.
delete_time_off_requestDelete time off requestDELETEDeletes the time off request. Approved or paid time off requests cannot be deleted.
get_time_off_requestGet time off requestGETReturns one time off request with per-day breakdown and balance_preview. Without a management role only your own and your led teams' requests are visible; others answer 404.
list_time_off_requestsList time off requestsGETLists time off requests, filtered by created, starts_at, approved_at ranges and user_ids. Without a management role, only your own and your led teams' requests are returned.

Update, 4 operations

list_organization_activity_updatesList organization activity updatesGETLists 10-minute activity blocks changed within an updated[start]/updated[stop] window, for syncing. Window at most 7 days, earliest 45 days ago; data may lag up to 20 minutes.
list_organization_daily_activity_updatesList organization daily activity updatesGETLists daily activity totals modified within an updated[start]/updated[stop] window, for syncing. Window at most 31 days; only activities from the last month are returned.
list_project_activity_updatesList project activity updatesGETLists one project's 10-minute activity blocks changed within an updated[start]/updated[stop] window, for syncing. Window at most 7 days, earliest 45 days ago; data may lag up to 20 minutes.
list_project_daily_activity_updatesList project daily activity updatesGETLists one project's daily activity totals modified within an updated[start]/updated[stop] window, for syncing. Window at most 31 days; only activities from the last month are returned.

Activity, 3 operations

list_insights_activityList insights activityGETInsights report: active and input-tracked seconds per date, member and project within date[start]/date[stop]. Needs the Insights add-on and owner or manager access; limited to 120 calls per hour.
list_organization_activitiesList organization activitiesGETLists tracked activity in 10-minute blocks (tracked, keyboard, mouse, overall seconds) for the organization. time_slot range at most 7 days, earliest 6 months ago; data may lag up to 20 minutes.
list_project_activitiesList project activitiesGETLists tracked activity in 10-minute blocks (tracked, keyboard, mouse, overall seconds) for one project. time_slot range at most 7 days, earliest 6 months ago; data may lag up to 20 minutes.

Client, 3 operations

create_clientCreate clientPOSTCreates a new client. Returns the created client.
get_clientGet clientGETReturns the client with the given ID.
list_clientsList clientsGETReturns a collection of clients for the given organization. Results can be filtered by status.

Global todo, 3 operations

create_global_todoCreate global todoPOSTCreates a global to-do. Returns the created global to-do. Global to-dos can be added to multiple projects.
delete_global_todoDelete global todoDELETEDeletes a global to-do. Irreversible: a deleted to-do can never be combined or reported with a new one, even of the same name.
list_global_todosList global todosGETReturns a collection of global to-dos for the given organization.

Job site, 3 operations

create_job_siteCreate job sitePOSTCreates a new job site. Returns the created job site.
get_job_siteGet job siteGETReturns the job site with the given ID.
list_job_sitesList job sitesGETReturns a collection of job sites (geofenced locations) for the organization. Results can be filtered by created[start]/[stop].

Note, 3 operations

get_noteGet noteGETReturns the note with the given ID.
list_organization_notesList organization notesGETLists notes members left while tracking, within time_slot[start]/time_slot[stop] (at most 31 days, earliest 3 years ago). Filter by user_ids, project_ids, task_ids.
list_project_notesList project notesGETLists notes members left while tracking on one project, within time_slot[start]/time_slot[stop] (at most 31 days, earliest 3 years ago).

Overtime policy, 3 operations

create_overtime_policyCreate overtime policyPOSTCreates an overtime policy: threshold hours per week (weekly) or day (daily) before pay_rate_multiplier applies, for user_ids who all need a pay rate. Starts at the next week or day boundary.
get_overtime_policyGet overtime policyGETReturns the overtime policy with the given ID. Only organization Owners and Managers may use this endpoint.
list_overtime_policiesList overtime policiesGETReturns a collection of overtime policies for the given organization. Only organization Owners and Managers may use this endpoint.

Archive, 2 operations

archive_overtime_policyArchive overtime policyPOSTArchives an overtime policy (they are never deleted): a policy in use closes at the start of the organization's next week, an unused one at once.
archive_time_off_policyArchive time off policyPOSTArchives the time off policy. Returns the archived time off policy.

Attendance schedule, 2 operations

create_attendance_scheduleCreate attendance schedulePOSTCreates an expected work shift for a user. Returns the created attendance schedule. For repeating schedules, specify repeat_schedule (weekly/bi_weekly) and weekdays.
list_attendance_schedulesList attendance schedulesGETLists attendance schedules (expected work shifts) covering date[start]/date[stop]; a repeating schedule is included when any occurrence falls in the range.

Last activity, 2 operations

list_organization_last_activitiesList organization last activitiesGETReturns the most recent activity for each member in the organization.
list_project_last_activitiesList project last activitiesGETReturns the most recent activity for each member in the project.

Limit history, 2 operations

get_limit_historyGet limit historyGETReturns the limit history with the given ID.
list_limit_historiesList limit historiesGETReturns a collection of limit histories (tracking limit configuration changes) for the given organization. Results can be filtered by user_ids[], date[start], and limit_type.

Location, 2 operations

list_organization_locationsList organization locationsGETLists the GPS positions recorded for the organization's members within time_slot[start]/time_slot[stop] (at most 7 days). Personal location data.
list_project_locationsList project locationsGETLists the GPS positions recorded for one project's members within time_slot[start]/time_slot[stop] (at most 7 days). Personal location data.

Manual time request, 2 operations

get_manual_time_requestGet manual time requestGETReturns the manual time request with the given ID.
list_manual_time_requestsList manual time requestsGETLists manual time requests whose time span overlaps date[start]/date[stop] (organization-local dates, both required). The filter is an overlap, not an exact match on the date field.

Organization, 2 operations

get_organizationGet organizationGETReturns the organization with the given ID.
list_organizationsList organizationsGETLists the organizations the authenticated member belongs to (id, name, status). Start here: every organization-scoped tool takes the organization_id this returns.

Team payment, 2 operations

get_team_paymentGet team paymentGETReturns one payroll payment made to a member. Payroll data.
list_team_paymentsList team paymentsGETLists payroll payments made to members (amounts, dates). Filter by created range, user_ids, project_ids; with no dates the last 3 years are returned. Payroll data.

Time edit log, 2 operations

list_organization_time_edit_logsList organization time edit logsGETLists manual time additions, edits and deletions in the organization within created[start]/created[stop] (at most 31 days, earliest 3 years ago).
list_project_time_edit_logsList project time edit logsGETLists manual time additions, edits and deletions on one project within created[start]/created[stop] (at most 31 days, earliest 3 years ago).

Time off balance, 2 operations

adjust_time_off_balancesAdjust time off balancesPOSTApplies manual time off balance adjustments: each entry names a policy, users, an amount in seconds and whether it adds to or replaces the balance. Users not on the policy are assigned to it first.
list_time_off_balancesList time off balancesGETReturns time off balances for the given organization. Each entry represents one user's balance for one time off policy in the requested year.

Tool usage, 2 operations

list_organization_tool_usagesList organization tool usagesGETLists app and website usage records within time_slot[start]/time_slot[stop] (at most 7 days, earliest 1 month ago). Prefer list_organization_daily_tool_usages. Owner or manager with view-others-data permission.
list_project_tool_usagesList project tool usagesGETLists app and website usage records of one project within time_slot[start]/time_slot[stop] (at most 7 days, earliest 1 month ago). Prefer list_project_daily_tool_usages.

Add rule, 1 operation

add_job_site_rulesAdd job site rulesPUTAdds new rules to a job site. Returns the updated job site.

Attendance shift, 1 operation

list_attendance_shiftsList attendance shiftsGETLists actual work shifts (clock-in and clock-out records) of the organization within date[start]/date[stop], at most 31 days apart and inside the organization's retention period.

Audit log entry, 1 operation

list_audit_log_entriesList audit log entriesGETLists audit log entries of the organization within created[start]/created[stop] (at most 7 days; slide the window for longer). Enterprise plan only; owner or manager with view-others-data permission.

Bulk, 1 operation

bulk_create_invitesBulk create invitesPOSTInvites up to 50 people at once; Hubstaff emails each invite. Processed one by one: failures do not stop the rest, and hitting the rate limit marks the remainder rate_limited. Returns counts and per-email results.

Client invoice, 1 operation

list_client_invoicesList client invoicesGETReturns invoices sent to clients for the given organization. Results can be filtered by client_ids[], issue_date[start]/[stop], and status.

Focus time, 1 operation

list_insights_focus_timeList insights focus timeGETInsights report: focus session totals and tracked seconds per date, member and project within date[start]/date[stop]. Needs the Insights add-on and owner or manager access; limited to 120 calls per hour.

Holiday, 1 operation

list_holidaysList holidaysGETReturns a collection of holidays for the given organization. Results can be filtered by created[start]/[stop] and date[start]/[stop].

Idle time, 1 operation

list_insights_idle_timeList insights idle timeGETInsights report: idle and worked seconds per date, member and project within date[start]/date[stop]. Needs the Insights add-on and owner or manager access; limited to 120 calls per hour.

Job site visit, 1 operation

list_job_site_visitsList job site visitsGETReturns a collection of job site visits (geofence entry/exit records) for the given organization. Results can be filtered by user_ids[] and enter[start]/[stop].

Me, 1 operation

get_current_userGet current userGETReturns the Hubstaff user the token acts as (id, name, email, time zone, status).

Meeting, 1 operation

list_insights_meetingsList insights meetingsGETInsights report: meeting time, count and cost per date and member within date[start]/date[stop]; empty when no calendar integration has synced. Insights add-on, owner or manager; 120 calls per hour.

Passive job site visit, 1 operation

list_passive_job_site_visitsList passive job site visitsGETReturns a collection of passive job site visits (automatic location detections without active geofence triggers). Results can be filtered by user_ids[] and enter[start]/[stop].

Seat, 1 operation

get_organization_seatsGet organization seatsGETReturns the organization's billing seat counters: paid seats, occupied seats and open seats (open seats are removed at the next billing cycle).

Smart notification, 1 operation

list_smart_notificationsList smart notificationsGETLists smart notification occurrences within created[start]/created[stop]. By default only those the caller receives; user_ids and team_ids filter on who TRIGGERED the notification.

Team invoice, 1 operation

list_team_invoicesList team invoicesGETLists internal payroll invoices of members. Filter by user_ids, issue_date range and status. Payroll data.

Time entry, 1 operation

create_time_entryCreate time entryPOSTAdds a time entry for a user. Manual time that requires approval cannot be added this way. Returns success true.

Timesheet, 1 operation

list_timesheetsList timesheetsGETReturns a collection of timesheets (aggregate approval records) for the given organization. Results can be filtered by date[start]/[stop], approved[start], and status.

Tool classification, 1 operation

list_tool_classificationsList tool classificationsGETLists apps or websites (one tool_type per call) with their productivity and category classification. Needs the Insights add-on and owner or manager access.

Tracking state, 1 operation

list_tracking_statesList tracking statesGETLists timer start and stop events of members within occurred[start]/occurred[stop] (at most 7 days), in insertion order: sort by occurred_at for a timeline. Removed members are excluded unless include_removed=true.

Unusual activity, 1 operation

list_unusual_activitiesList unusual activitiesGETReturns a collection of unusual activities (anomalous behavior patterns) for the given organization.

User, 1 operation

get_userGet userGETReturns the user with the given ID.

User policy, 1 operation

list_user_time_off_policiesList user time off policiesGETReturns active time off policies that the specified user is a member of. Used to determine which policies are available when creating a time off request.

Work time classification, 1 operation

list_insights_work_time_classificationList insights work time classificationGETInsights report: tracked seconds split into core, non-core and unproductive per date, member and project. Needs the Insights add-on and owner or manager access; limited to 120 calls per hour.

Showing the first 120 of 148 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use Hubstaff from Claude Code, Cursor or Codex

Connect Hubstaff in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Hubstaff operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Hubstaff

Create your workspace
Sign up free. Nothing to install.
Connect Hubstaff once
Add your Hubstaff connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.