Update an employee
Change fields on an employee profile.
MCP tool personio_write → update_employee
write Confirm
Updates the Personal Info fields you name on one profile, and returns old and new values. With Propose permissions the change goes to approval; with Edit permissions it is saved. Fields your role cannot edit are rejected by name. Compensation and other fields outside your permissions are never touched. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee ID from list_employees. |
| fields object required | object | Field names and new values, for example {"team": "Customer Success"}. |
| effective_from string | string | Date the change takes effect, YYYY-MM-DD. Default today. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "personio_write",
"arguments": {
"operation": "update_employee",
"arguments": {
"employee_id": "employee_8c41d2",
"fields": "fields"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"employee_id": "emp_2041",
"changed": {
"team": {
"from": "Marketing",
"to": "Customer Success"
},
"supervisor": {
"from": "Tom Becker",
"to": "Sam Okafor"
}
},
"status": "saved"
},
"isError": false
}