List employees
Employees with name, team, job title, supervisor and status, newest first.
MCP tool personio_read → list_employees
read
Lists employees you may see in Personio, newest first. Filter by team, status or a name fragment. Only the attributes your role may read are returned; others come back empty. Pages hold up to 100 employees; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| team string | string | Team name as shown in Personio. |
| status string | string | 'active' (default), 'inactive' or 'onboarding'. |
| search string | string | Part of the first or last name. |
| limit integer | integer | Items per page, 1 to 100. Default 100. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "personio_read",
"arguments": {
"operation": "list_employees",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"employees": [
{
"employee_id": "emp_2041",
"name": "Maja Kowalska",
"team": "Marketing",
"position": "Content Lead",
"supervisor": "Tom Becker",
"status": "active",
"hired_at": "2024-03-01"
}
],
"next_cursor": "eyJvZmZzZXQiOjEwMH0"
},
"isError": false
}