Skills bamboohr-automation
📦

bamboohr-automation

Low Risk ⚙️ External commands🌐 Network access

Automate BambooHR HR operations with AI

Streamline human resources workflows by connecting AI assistants to BambooHR through MCP. Execute employee searches, time-off management, and benefits tracking without manual portal navigation.

Supports: Claude Codex Code(CC)
📊 69 Adequate
1

Download the skill ZIP

2

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

3

Toggle on and start using

Test it

Using "bamboohr-automation". Find all employees in the Sales department

Expected outcome:

Employee directory query returns 12 Sales team members with fields: firstName, lastName, workEmail, jobTitle, and status. Results include active sales representatives and one recently terminated employee flagged by status field.

Using "bamboohr-automation". Submit vacation request for John Smith, March 10-14, 2026

Expected outcome:

Time-off request created successfully with ID 4892. Request shows employeeId 156, timeOffTypeId 3 (Vacation), start date 2026-03-10, end date 2026-03-14, amount 5 days. Status is pending manager approval.

Security Audit

Low Risk
v1 • 2/25/2026

Static analysis flagged 61 patterns that are all false positives. The 52 external_commands detections are markdown backticks for tool names, not shell execution. The network finding is a legitimate MCP endpoint URL. Cryptographic algorithm findings reference no actual crypto code. This documentation-only skill safely connects to BambooHR via standard MCP protocol.

1
Files scanned
226
Lines analyzed
2
findings
1
Total audits
Audited by: claude

Quality Score

38
Architecture
100
Maintainability
87
Content
32
Community
90
Security
91
Spec Compliance

What You Can Build

HR Manager Dashboard

Query employee directories, approve pending time-off requests, and generate change reports for weekly team meetings

Payroll Sync Automation

Detect employee changes since last payroll run and update external payroll systems with modified employee data

Employee Self-Service Assistant

Enable employees to check their time-off balances, submit vacation requests, and view their dependents through natural language queries

Try These Prompts

Find Employee Contact
Search the employee directory for someone in the Engineering department and return their name, email, and job title
Time-Off Request Submission
Check my available vacation balance, then submit a time-off request from 2026-03-15 to 2026-03-20 for 5 days with the note 'Family vacation'
Incremental Employee Sync
Get all employees who have been updated since 2026-02-01T00:00:00Z, retrieve their full profiles, and list the changed fields for each
Bulk Time-Off Approval
List all pending time-off requests for next month, then approve all requests from the Marketing department and deny any that exceed 10 days

Best Practices

  • Always call RUBE_SEARCH_TOOLS first to retrieve current tool schemas before executing workflows
  • Resolve employee names to numeric IDs via GET_ALL_EMPLOYEES before performing detailed operations
  • Store and reuse timestamps for incremental sync patterns to avoid redundant API calls

Avoid

  • Do not call GET_EMPLOYEE for each employee in a loop when GET_ALL_EMPLOYEES provides directory data more efficiently
  • Avoid submitting time-off requests without first checking available balances via GET_TIME_OFF_BALANCES
  • Never hardcode employee IDs or time-off type IDs; always resolve them dynamically from current data

Frequently Asked Questions

What do I need before using this skill?
You need Rube MCP connected in your AI client and an active BambooHR connection. Run RUBE_MANAGE_CONNECTIONS with toolkit 'bamboohr' to authenticate if not already active.
How do I find an employee's ID?
Call BAMBOOHR_GET_ALL_EMPLOYEES to retrieve the directory, then search results by name. The employee ID is a numeric field used for detailed operations.
Can I automatically approve time-off requests?
Yes, if your BambooHR API key has manager or admin permissions. Use UPDATE_TIME_OFF_REQUEST with status 'approved' after retrieving the requestId.
What date formats does BambooHR expect?
Time-off dates use 'YYYY-MM-DD' format. Change detection timestamps use ISO 8601 format with timezone like '2026-02-01T00:00:00Z'.
Are terminated employees included in search results?
Yes, GET_ALL_EMPLOYEES may include inactive employees. Check the 'status' field to filter for active employees only.
How do I keep external systems synced with BambooHR?
Use the incremental sync pattern: store last_sync_timestamp, call EMPLOYEE_GET_CHANGED with that timestamp, fetch details for changed employees, then update your timestamp.

Developer Details

File structure

📄 SKILL.md