`bamboohr_get_directory`

Pack: bamboohr · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

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 — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the bamboohr pack

{
  "mcpServers": {
    "bamboohr": {
      "url": "https://gateway.pipeworx.io/bamboohr/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

bamboohr_get_directory