Create task
Creates a task and assigns it to an employee.
MCP tool peoplehr_write → create_task
write Confirm
Creates the task from the plus icon in the Tasks area. An admin can assign it to anyone, a manager only to employees who report to them, and PeopleHR refuses someone who is leaving. Documents cannot be attached to a task. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| title string required | string | Task title. |
| assignee_id string required | string | Employee ID of the person who does the task. |
| about_employee_id string | string | Employee ID the task is in relation to, for example a new starter. |
| completion_date string | string | Completion date, YYYY-MM-DD. Optional. |
| description string | string | What to do. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "peoplehr_write",
"arguments": {
"operation": "create_task",
"arguments": {
"title": "Book first 1:1",
"assignee_id": "PW8",
"about_employee_id": "PW41",
"completion_date": "2026-11-23",
"description": "Book a 30 minute 1:1 in the first week."
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"task_id": "tsk-3301",
"title": "Book first 1:1",
"assignee": "Dana Reyes",
"about": "Ana Lopez",
"completion_date": "2026-11-23",
"status": "New"
},
"isError": false
}