# Humanforce MCP by usefulapi

> Humanforce MCP by usefulapi is an MCP server. Read employees, rosters, timesheets, leave requests and clocking status in Humanforce. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/humanforce/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/humanforce
- **MCP Registry name:** io.usefulapi/humanforce
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://humanforce.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "humanforce": {
      "url": "https://humanforce.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/humanforce-mcp-by-usefulapi
