# Talenox MCP by usefulapi

> Talenox MCP by usefulapi is an MCP server. Review employees, payroll and leave, and approve or reject Talenox leave applications. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Review employees, payroll and leave, and approve or reject Talenox leave applications.

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `talenox_list_employees`: List the company's employees as a short summary (id, employee_id, names, email, hired/resign dates, current job). Talenox returns every employee in one reply, so use search to narrow and limit/offset to page here. Use talenox_get_employee for the full record. Sensitive fields (national id, passport, bank account) are never included.
- `talenox_get_employee`: Get one employee's full record: personal details, jobs, cost centres, custom fields. National id, passport, bank account and health fields are left out unless include_sensitive is true.
- `talenox_get_job`: Get one job record of an employee (title, department, start/end date, pay amount and rate, currency). Job ids are in the employee's `jobs` list.
- `talenox_list_branches`: List the company's branches with their head and employee ids.
- `talenox_get_branch`: Get one branch (name, address, head, employee ids).
- `talenox_list_cost_centres`: List the company's cost centres with their employee ids.
- `talenox_list_roles`: List the company's employee roles (access roles).
- `talenox_get_role`: Get one employee role.
- `talenox_get_company_settings`: Get the company's API-related settings (for example whether an employee may belong to several cost centres).
- `talenox_list_working_days`: List the working-day schedules (weekly pattern Sunday to Saturday: full_day, first_half, second_half, not_working) and who is on each.
- `talenox_get_working_day`: Get one working-day schedule.
- `talenox_list_holiday_policies`: List the company's public-holiday policies (country, state, default flag). Paged: pass next_last_seen_id as last_seen_id.
- `talenox_get_holiday_policy`: Get one holiday policy with its calendar events between two dates.
- `talenox_list_company_holidays`: List the company's holidays (from its default holiday policy) for a year.
- `talenox_list_leave_applications`: List leave applications that overlap a date range, optionally by status, employee, approver or leave type. Paged: pass next_last_seen_id as last_seen_id. Uses Talenox's leave API (beta).
- `talenox_get_leave_application`: Get one leave application (employee, dates, half-day markers, amount, status, approvers, attachments).
- `talenox_list_leave_types`: List the leave types of the company, or those an employee may apply for (employee_id). Paged: pass next_last_seen_id as last_seen_id.
- `talenox_get_leave_type`: Get one leave type (name, half-day allowed, quantity type, policy dates).
- `talenox_get_leave_balance`: Get an employee's leave balance on a date, for every leave type or for one (leave_type_id). A type that does not apply to the employee comes back with an error text instead of a balance.
- `talenox_get_leave_entitlement_period`: Get the entitlement periods (start and end dates) of one leave type for an employee around a date.
- `talenox_list_off_in_lieus`: List the off-in-lieu types of the company, or of one employee. Paged: pass next_last_seen_id as last_seen_id.
- `talenox_get_off_in_lieu_balance`: Get an employee's off-in-lieu balance on a date, for every off in lieu or for one (off_in_lieu_id).
- `talenox_list_payroll_payments`: List the payroll payment runs of a month (period, pay group, status Draft or Processed, bank file state).
- `talenox_get_payroll_payment`: Get one payroll payment run (period, status, bank file and cheque export state).
- `talenox_list_custom_pay_items`: List the company's pay item definitions (name, category such as Adhoc or Recurring, taxable, gross/net setting).
- `talenox_get_payslips_data`: Get the payslip figures (gross, net, deductions, year-to-date) of a month as data, for all employees or the listed ones. Read only: nothing is created, processed or published. Contains salary data.
- `talenox_approve_leave_application`: WRITE: approve a leave application as the token's user. The employee's balance and payroll are affected and Talenox may notify them. Read the application first (talenox_get_leave_application) and confirm with the user.
- `talenox_reject_leave_application`: WRITE: reject a leave application as the token's user. Talenox may notify the employee. Read the application first (talenox_get_leave_application) and confirm with the user.

## FAQ

### How do I add Talenox MCP by usefulapi to Claude Code?

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

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