Skip to content
MCP server

Humanforce MCP by usefulapi

Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.

Install
Runs
Remotely
Version
1.3.0
Listing updated
4 days ago

About Humanforce MCP by usefulapi

Humanforce MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http humanforce https://humanforce.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://humanforce.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "humanforce": {
      "url": "https://humanforce.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "humanforce": {
      "type": "http",
      "url": "https://humanforce.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "humanforce": {
      "serverUrl": "https://humanforce.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "humanforce": {
      "type": "http",
      "url": "https://humanforce.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (14)

Read directly from the server.

humanforce_list_employees
List employees with summary details (code, name, default location, department and role, active status). Humanforce API: GET /api/1.0/employees.
humanforce_get_employee
Get one employee with all details (personal, employment, roles, locations and departments). Humanforce API: GET /api/1.0/employees/{guidKey}.
humanforce_list_locations
List locations with summary data (site names and codes). Humanforce API: GET /api/1.0/locations.
humanforce_list_departments
List all departments. Humanforce API: GET /api/1.0/departments.
humanforce_list_roles
List all roles (job roles used for rostering and pay). Humanforce API: GET /api/1.0/roles.
humanforce_list_shift_types
List shift types, including leave types when isLeaveType is true. Humanforce API: GET /api/1.0/shiftTypes.
humanforce_list_pay_types
List all pay types used in timesheets and payruns. Humanforce API: GET /api/1.0/payTypes.
humanforce_list_pay_companies
List the pay companies (legal payroll entities) in this tenant. Humanforce API: GET /api/1.0/PayCompany.
humanforce_list_roster_items
List rostered shifts between two dates, with filters for employee, location, department and role. Humanforce API: GET /api/1.0/rosterItems.
humanforce_list_availability
List employee availability between two dates, optionally for one employee, location or department. Humanforce API: GET /api/1.0/availability.
humanforce_list_public_holidays
List public holidays between two dates, optionally for one region. Humanforce API: GET /api/1.0/publicHolidays.
humanforce_get_clocking_status
Get whether an employee is clocked in or out now, in their local time. Humanforce API: GET /api/1.0/clocking/status.
humanforce_list_timesheets
List timesheets in a date range (or pay-date range), with filters for employee, location and approval. Humanforce API: GET /api/1.0/timesheets.
humanforce_list_leave_requests
List leave requests in a date range, optionally only approved ones or for one employee. Humanforce API: GET /api/1.0/leaveRequest.

Humanforce MCP by usefulapi FAQ

How do I add Humanforce MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http humanforce https://humanforce.usefulapi.io/mcp