BambooHR MCP 服务器

npm install -g @twentytwokhz/bamboohr-mcp

npx @twentytwokhz/bamboohr-mcp

git clone https://github.com/twentytwokhz/bamboohr-mcp.git
cd bamboohr-mcp
npm install
npm run build

BAMBOOHR_API_KEY=your_api_key_here
BAMBOOHR_COMPANY_DOMAIN=your_company_subdomain

{
  "mcpServers": {
    "bamboohr": {
      "command": "npx",
      "args": ["@twentytwokhz/bamboohr-mcp"],
      "env": {
        "BAMBOOHR_API_KEY": "your_api_key_here",
        "BAMBOOHR_COMPANY_DOMAIN": "your_domain"
      }
    }
  }
}

{
  "mcpServers": {
    "bamboohr": {
      "command": "bamboohr-mcp",
      "args": [],
      "env": {
        "BAMBOOHR_API_KEY": "your_api_key_here",
        "BAMBOOHR_COMPANY_DOMAIN": "your_domain"
      }
    }
  }
}

{
  "mcpServers": {
    "bamboohr": {
      "command": "node",
      "args": ["/absolute/path/to/bamboohr-mcp/dist/index.js"],
      "env": {
        "BAMBOOHR_API_KEY": "your_api_key_here",
        "BAMBOOHR_COMPANY_DOMAIN": "your_domain"
      }
    }
  }
}

"Create new employee John Doe in Engineering department"
"Update employee 123's job title to Senior Developer"
"Add new compensation record for employee 456"

"Create PTO request for employee 123 from Jan 15-17"
"Approve time off request 456"
"Add 5 vacation days to employee 789's balance"

"Upload performance review to employee 123's files"
"Update employee 456's profile photo"
"Delete file 789 from employee 123" (requires confirm: true)

"Create Q1 sales target goal for employee 123"
"Update goal 456 progress to 75%"
"Add comment to goal 789: Great progress this month"

"Add Azure AZ-104 certification for employee 123"
"Update training record 456 with completion date"
"Show all available training types"

"Create job opening for Senior Developer position"
"Add candidate John Smith to job posting 123"
"Move applicant 456 to interview stage"

"Add spouse dependent for employee 123"
"Show all dependents in the company"
"What benefit plans are available?"

"Clock in employee 123"
"Clock out employee 123 with note 'Lunch break'"
"Add 8 hours for employee 456 on project XYZ"

"Which certifications are expiring in February 2026?"
"Show all Azure certifications due before end of Q1"
"Get company-wide certification compliance by department"
"What assessments are due this month?"
"Show overdue items for employee 123"
"Goal progress report grouped by status"

{
  "employee_id": "123",
  "file_id": "456",
  "confirm": true  // Required for deletion
}

{
  "id": "123",
  "firstName": "John",
  "lastName": "Doe",
  "email": "john@example.com"
}

# Employee: John Doe

**ID:** 123
**Email:** john@example.com
**Job Title:** Software Engineer

"Show me the employee directory"
"Get details for employee ID 123"
"Create new employee Jane Smith in Marketing"
"Update employee 456's department to Engineering"

"Who's out today?"
"Show all pending time off requests"
"Approve time off request 789"
"What's employee 123's PTO balance?"

"Show all open job positions"
"Create a job posting for Backend Developer"
"Add candidate resume to job opening 456"
"Move applicant to final interview stage"

"Create Q1 goals for employee 123"
"Show progress on all goals for employee 456"
"Update goal completion to 100%"

bamboohr-mcp-server/
├── src/
│   ├── index.ts                    # Main entry point
│   ├── constants.ts                # API constants
│   ├── types.ts                    # TypeScript types
│   ├── services/
│   │   ├── bamboohr-client.ts      # API client with auth & file uploads
│   │   └── formatting.ts           # Response formatting
│   ├── schemas/
│   │   └── common.ts               # Validation schemas
│   └── tools/
│       ├── employees.ts            # Employee CRUD (9 tools)
│       ├── timeoff.ts              # Time off CRUD (9 tools)
│       ├── files.ts                # File management (6 tools)
│       ├── goals.ts                # Goals & performance (7 tools)
│       ├── metadata.ts             # Metadata & training (10 tools)
│       ├── applicant-tracking.ts   # ATS (10 tools)
│       ├── benefits.ts             # Benefits & dependents (7 tools)
│       ├── time-tracking.ts        # Time tracking (7 tools)
│       └── assessments.ts          # Certifications & assessments (7 tools)
├── dist/                           # Compiled JavaScript (cross-platform)
├── .env                            # Your credentials (don't commit!)
└── README.md

# Build the project
npm run build

# Development mode (watch for changes)
npm run dev

# Clean build artifacts
npm run clean

{
  content: [{ type: 'text', text: '...' }],
  isError?: boolean
}