List employees
Lists employees from the employee list.
MCP tool peoplehr_read → list_employees
read
Returns the employee ID, name, job title, department and start date of each person in the list your role can see. Leavers are not included. Use the employee ID in get_employee and get_employee_planner.
Parameters
| Name | Type | Description |
|---|---|---|
| search string | string | Part of a name. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "peoplehr_read",
"arguments": {
"operation": "list_employees",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"employees": [
{
"employee_id": "PW41",
"name": "Ana Lopez",
"job_title": "Account Executive",
"department": "Sales",
"start_date": "2026-11-16"
},
{
"employee_id": "PW15",
"name": "Priya Nair",
"job_title": "Software Engineer",
"department": "Engineering",
"start_date": "2024-03-04"
}
],
"next_cursor": null
},
"isError": false
}