# BambooHR MCP > BambooHR MCP connects your AI client to BambooHR data, letting you manage HR tasks via natural conversation. Instead of clicking through complex menus, your agent can search employee directories, audit time off requests, and pull company reports instantly. It's direct access to people data for managers and admins. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-directory, time-off-tracking, hr-automation, people-management, reporting ## Description BambooHR lets your AI agent handle the bulk of routine human resources work. You stop navigating dense HR dashboards and start having a conversation with your people data. Your agent can immediately find employee contact details, check who is out today, or audit time off requests—all without you knowing which menu tab to click first. If you're an admin updating records or a manager checking team availability, this MCP acts as a direct bridge into your organization’s core data. By connecting BambooHR through Vinkius, your AI client gains the ability to execute complex HR operations that used to take minutes of clicking and switching tabs. You get immediate answers and actions from natural language prompts. ## Tools ### add_time_off_request Submits a new leave request for an employee in the system. ### get_account_check Verifies that your connection to BambooHR is active and working correctly. ### get_company_report Retrieves a specific, pre-defined company report using its unique ID. ### get_employee_details Gets basic contact and profile information for one specific employee. ### list_employees_directory Lists all currently active employees in the company directory. ### list_time_off_policies Shows every time off policy defined within your organization. ### list_time_off_requests Retrieves a list of all current or past time off requests. ### list_time_off_types Lists every type of leave available, like vacation or sick pay. ### list_whos_out Provides a quick summary of who is currently out of the office. ### search_employee Searches for an employee by name within the company directory. ### update_employee Changes or corrects basic information stored in an employee's record. ### whos_out Lists employees who are out of the office for a specified start and end date range. ## Prompt Examples **Prompt:** ``` Who is out of the office today? ``` **Response:** ``` Checking BambooHR... Today, Jane Doe (Vacation) and John Smith (Sick Leave) are out. Would you like to check availability for a different date range? ``` **Prompt:** ``` Search for 'Sarah' in the employee directory. ``` **Response:** ``` I found Sarah Miller. She is a 'Senior Engineer' in the 'Product' team. Her email is sarah.miller@example.com. Would you like her extension or office location? ``` **Prompt:** ``` What are my available time off types? ``` **Response:** ``` Retrieving time off types... You have access to: Vacation, Sick Leave, Personal Day, and Bereavement. Which one would you like to request? ``` ## Capabilities ### Search employee records Find basic contact details or profile information for any active employee. ### Manage time off requests Submit new leave applications, list existing requests, and see what policies you can use. ### Determine team availability Check who is out of the office for today or a specific date range to plan projects. ### Update employee information Programmatically correct or update basic details in the HR record. ### Generate company reports Retrieve custom, specific company data reports by ID. ## Use Cases ### Coordinating a complex project launch An operations lead needs to know which members of the 'Product' team are free for a week in November. Instead of emailing 15 people, they ask their agent: 'Who is out from Nov 10th to Nov 17th?' The agent uses `whos_out` and immediately provides a clean list of available staff. ### Processing an employee change An HR admin needs to update Jane Doe's job title. They tell their agent, 'Update Jane Doe's role to Senior Manager.' The agent uses `update_employee`, logs the change in BambooHR, and confirms it instantly. ### Needing a quarterly audit report A manager needs to show leadership team turnover data. They ask their agent for 'Q2 Employee Headcount Report.' The agent uses `get_company_report`, pulls the necessary data, and presents it without needing manual export or dashboard navigation. ### New hire onboarding coordination A new manager needs to know a teammate's direct contact information. They simply ask: 'What is John Smith's work email?' The agent uses `search_employee` and returns the exact, up-to-date contact details immediately. ## Benefits - You save time by getting immediate availability insights. Instead of checking calendars and asking colleagues, your agent can use the `whos_out` tool to tell you exactly who is away for project planning. - HR admins eliminate manual record entry. You can update employee details instantly using `update_employee`, ensuring HR records are always accurate without logging into a dashboard. - Time off becomes simple. Don't search through policies; just ask your agent, and it will use the `list_time_off_types` tool to show you what options are available for requesting time off. - Forget digging through menus to find team members. You can get basic contact details instantly by telling your agent to search the directory using `search_employee`. - You gain full visibility into company performance metrics. Use the `get_company_report` tool to pull specific, custom reports without knowing the underlying report ID. ## How It Works The bottom line is: you talk to your agent, it talks to BambooHR, and you get an action or answer back in plain text. 1. First, you subscribe to this MCP and input your BambooHR Subdomain and API Key into Vinkius. 2. Next, you prompt your AI client with a request, like 'Who is out next Tuesday?' 3. The agent executes the necessary tool calls against BambooHR and provides a direct, conversational answer. ## Frequently Asked Questions **How do I use BambooHR MCP to find an employee's contact info?** You can use the `search_employee` tool by asking your agent for the person's name. It quickly returns their basic details and profile information from the directory. **Can I check team availability with BambooHR MCP?** Yes, you can check who is out of office using the `whos_out` tool. You just need to tell your agent the specific date range you want to verify coverage for. **What if I need to submit a new time off request?** Use the `add_time_off_request` tool. Simply ask your agent to process the request, and it submits the application directly into BambooHR on your behalf. **Does this MCP help me with company reporting?** Yes, you can get a specific report using `get_company_report`. You only need to provide the report's ID and let the agent retrieve the data for you.