# BambooHR MCP for AI Agents MCP > BambooHR MCP is an AI connector that makes your entire HR ecosystem accessible through natural conversation. Your agent can instantly pull employee directories, audit full profiles for any worker, track time off status, or fetch structured historical data like compensation records—all without you opening a single dashboard. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-management, hr-automation, time-off-tracking, directory, compensation-data ## Description Managing people operations shouldn't feel like navigating a maze of tabs and dropdown menus. This MCP connects your AI client directly to BambooHR, letting your agent act as an instant HR operations specialist. Instead of logging in, clicking through multiple screens just to piece together data, you simply ask the question. The agent can instantly list every active employee in the company directory, pull detailed information for any specific person—including their department and job title—and check files associated with them. Need to know who's out next month? You get a real-time summary of time off requests, showing if they're pending or approved. Furthermore, you don't have to rely on limited pre-built reports; the agent can access structured historical tables for job history and compensation data, letting you run custom reporting just by describing what fields you need. This power lets your AI client manage complex employee workflows from a simple chat prompt. Because Vinkius hosts this MCP, you get to use these powerful HR tools across any compatible platform, making it the central hub for all your people data. ## Tools ### list_meta_fields Lists all available data fields associated with employees in BambooHR. ### get_employee Retrieves specific details for a single employee by name or ID, allowing you to specify exactly what information you need. ### get_employee_table Pulls structured data from internal tables like job history or compensation records. ### list_employees Generates a complete list of all active employees in the company directory. ### list_employee_files Retrieves a list of files attached to an employee's profile. ### list_meta_tables Lists all available data tables (e.g., Job Info, Compensation) that can be queried in BambooHR. ### list_time_off_requests Retrieves a list of time off requests across the organization for review. ### update_employee Updates specific employee data fields using a structured input format. ### get_custom_report Generates a custom report by requiring you to provide a JSON list of the exact fields needed for analysis. ## Prompt Examples **Prompt:** ``` I need a list of all employees in Engineering and their current job titles. ``` **Response:** ``` **Engineering Department Directory** * John Doe: Senior Developer (ID 101) * Sarah Chen: Junior Dev (ID 215) * Marcus Lee: Team Lead (ID 304) Found 3 active employees. Do you need their department manager or start date? ``` **Prompt:** ``` Check the job history and compensation for employee ID 215. ``` **Response:** ``` **Employee 215: Sarah Chen** * **Job History:** Started as Intern (2023) -> Junior Developer (2024) * **Compensation Details:** Starting salary was $60k. Last adjustment in Q2 2024 increased it to $72,000. Full record available for audit. ``` **Prompt:** ``` Find all pending time off requests from the Marketing department. ``` **Response:** ``` **Pending Time Off Requests (Marketing)** The following 3 employees have pending leave that requires approval: * Alice Johnson: Personal Leave, May 15-May 17 (3 days) * Ben Clark: Family Time, June 1-June 3 (3 days) * Chris Yang: Sabbatical Request, July 1-July 30 (22 days) ``` ## Capabilities ### Retrieve Company Directory and Profiles List every active employee in the company directory or pull full metadata for a single worker. ### Audit Time Off Statuses Check all time off requests, filtering by status (pending/approved) or specific date ranges. ### Access Historical Compensation Data Get structured data tables containing job history and compensation details for auditing purposes. ### Generate Custom HR Reports Create specific reports on the fly by telling the agent exactly which employee fields you need to analyze. ## Use Cases ### Auditing department staffing levels An operations lead needs to know if Department X has enough people to cover Q3. They ask the agent to list employees and then filter by role, getting a real-time count and full directory details for immediate risk assessment. ### Investigating a payroll discrepancy HR needs to verify an employee's salary change. Instead of running multiple reports, they ask the agent to pull data from structured historical tables like compensation history (get_employee_table) for quick auditing. ### Handling an urgent leave request audit A manager needs to know if a team member can take PTO next month. They ask the agent about time off requests, and it immediately identifies pending leaves or available dates (list_time_off_requests). ### Compliance file review for termination The IT security team must verify an employee's access rights before departure. They ask the agent to list associated files and check their profile metadata, ensuring all necessary steps are logged (list_employee_files, get_employee). ## Benefits - Instantly check an employee's full profile metadata. Instead of digging through separate tabs, your agent fetches job titles, departments, and all relevant details in one go. - Manage leave without the headache. You can ask for a list of pending or approved time off requests across the whole company with a single prompt using list_time_off_requests. - Deep dives into history are easy. The agent accesses structured tables to pull compensation data and job changes (using get_employee_table) that would otherwise require complex report building. - Go beyond standard reports. By specifying fields for custom reporting, you gain access to highly targeted data that keeps your analysis precise and relevant. - Centralized oversight. You don't have to jump between the directory, file storage, and profile pages; your agent coordinates all these elements for a complete picture. ## How It Works The bottom line is that you talk to your HR system like talking to a person who already has all the data organized for you. 1. Subscribe to this MCP and enter your BambooHR Subdomain and API Key. 2. Connect your preferred AI client (Claude, Cursor, etc.) via the Vinkius catalog. 3. Ask your agent a natural language question about employee data or time off. The system runs the necessary queries and returns structured results in chat. ## Frequently Asked Questions **How do I list all active employees in my organization?** Use the `list_employees` tool. It retrieves the full company directory, providing a complete overview of active personnel. **Can I check the compensation history for a specific employee?** Yes! Use the `get_employee_table` tool with the employee's ID and specify 'compensation' as the table name to retrieve their full pay history. **How do I filter time off requests by their current status?** You can use the `list_time_off_requests` tool and provide a status like 'pending' or 'approved' as a parameter to narrow down the results.