Find employee
Employees matching a name in the directory, with the employee ID the other tools need.
MCP tool bamboohr_read → find_employee
read
Returns the employees whose name matches the query, with ID, job title, department and hire date. Fields your BambooHR account cannot see are left out, never filled in. Use employee_id from each item in the task, signature and time off tools. Returns up to 25 matches; refine the query for more.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Part of the employee name. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "bamboohr_read",
"arguments": {
"operation": "find_employee",
"arguments": {
"query": "query"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"employees": [
{
"employee_id": "412",
"name": "Ana Kowal",
"job_title": "Account Executive",
"department": "Sales",
"hire_date": "2026-10-19"
}
]
},
"isError": false
}