bamboohr_get_directory
Pack: bamboohr · Endpoint: https://gateway.pipeworx.io/bamboohr/mcp
No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/bamboohr_get_directory for the schema, then POST the same URL with its arguments for the data.
Get complete employee directory with names, titles, departments, contact info, and manager assignments for all staff.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
_apiKey | string | yes | BambooHR API key |
_subdomain | string | yes | BambooHR subdomain |
Example call
Arguments
{
"_apiKey": "your-bamboohr-api-key",
"_subdomain": "mycompany"
}
curl
curl -X POST https://gateway.pipeworx.io/bamboohr/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"bamboohr_get_directory","arguments":{"_apiKey":"your-bamboohr-api-key","_subdomain":"mycompany"}}}'
TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('bamboohr_get_directory', {
"_apiKey": "your-bamboohr-api-key",
"_subdomain": "mycompany"
});
Response shape
| Field | Type | Description |
|---|---|---|
employees | array | Complete employee directory |
Full JSON Schema
{
"type": "object",
"properties": {
"employees": {
"type": "array",
"description": "Complete employee directory",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Employee ID"
},
"firstName": {
"type": "string",
"description": "Employee first name"
},
"lastName": {
"type": "string",
"description": "Employee last name"
},
"jobTitle": {
"type": "string",
"description": "Employee job title"
},
"department": {
"type": "string",
"description": "Employee department"
},
"workEmail": {
"type": "string",
"description": "Employee work email"
},
"mobilePhone": {
"type": "string",
"description": "Employee mobile phone"
},
"manager": {
"type": "string",
"description": "Manager assignment"
}
}
}
}
}
}
Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"bamboohr": {
"url": "https://gateway.pipeworx.io/bamboohr/mcp"
}
}
}
See Getting Started for client-specific install steps.