`bamboohr_list_employees`

Pack: bamboohr · Endpoint: https://gateway.pipeworx.io/bamboohr/mcp

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/bamboohr_list_employees for the schema, then POST the same URL with its arguments for the data.

List all employees with directory info. Returns IDs, names, departments, job titles, and contact details.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	BambooHR API key
`_subdomain`	string	yes	BambooHR subdomain (e.g., “mycompany” from mycompany.bamboohr.com)

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_list_employees","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_list_employees', {
  "_apiKey": "your-bamboohr-api-key",
  "_subdomain": "mycompany"
});

Response shape

Field	Type	Description
`employees`	array	List of all employees with directory information

Full JSON Schema

{
  "type": "object",
  "properties": {
    "employees": {
      "type": "array",
      "description": "List of all employees with directory information",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Employee ID"
          },
          "firstName": {
            "type": "string",
            "description": "Employee first name"
          },
          "lastName": {
            "type": "string",
            "description": "Employee last name"
          },
          "department": {
            "type": "string",
            "description": "Employee department"
          },
          "jobTitle": {
            "type": "string",
            "description": "Employee job title"
          },
          "workEmail": {
            "type": "string",
            "description": "Employee work email"
          },
          "mobilePhone": {
            "type": "string",
            "description": "Employee mobile phone number"
          },
          "manager": {
            "type": "string",
            "description": "Manager name or ID"
          }
        }
      }
    }
  }
}

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.

bamboohr_list_employees