MCP server
Humanforce MCP by usefulapi
Read employees, rosters, timesheets, leave requests and clocking status in Humanforce.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://humanforce.usefulapi.io/mcpInstall 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