# HiBob MCP > HiBob MCP automates your entire people operations workflow through natural conversation. Manage employee data, track time off balances, process payroll history lookups, and handle onboarding tasks without touching a spreadsheet. Connect HiBob to any AI agent running in Claude, Cursor, or VS Code and treat your assistant like a dedicated HR Coordinator. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** people-management, time-off-tracking, employee-profiles, hr-automation, workforce-management ## Description You can manage nearly every aspect of people operations by connecting your hiBob platform. Instead of juggling multiple tabs, you talk to your agent. You can quickly search for employees using specific criteria to pull full profiles or just basic contact info. Need to know who's out this week? Your agent checks leave balances and identifies who is currently on time off. Want to submit a request? You can send new time off requests directly through the chat, and even mark open HR tasks as completed when they're finished. Payroll data isn't just for finance—your agent retrieves detailed compensation packages or pulls historical payroll records so you always have accurate information at your fingertips. When you connect this to Vinkius, you get a single point of access where your AI client acts like an instant People Ops Specialist. ## Tools ### complete_task Marks a specific, identified HR task as finished within the system. ### get_leave_balance Provides the current time off balance for an employee. ### get_employee_compensation Retrieves detailed information about an employee's salary and benefits package. ### get_payroll_history Accesses the platform's complete history of payroll data. ### list_public_profiles Pulls basic contact information for all currently active employees in the organization. ### get_whos_out Lists staff members who are on leave within a specified date range. ### invite_employee Sends an official welcome invitation to a new hire. ### list_company_settings_lists Retrieves all custom lists and configuration dropdowns used throughout the HiBob platform. ### list_open_tasks Lists every pending HR task that needs attention across the company. ### search_employees Searches for active employees using filters and returns detailed profiles based on criteria. ### request_time_off Submits a new time off request for an employee, requiring policy details, start date, and end date. ## Prompt Examples **Prompt:** ``` Search for employees in the 'Engineering' department. ``` **Response:** ``` I've searched your team. I found 12 employees in the Engineering department, including 'Mark Thompson' (Lead Engineer), 'Sarah Chen', and 'David Miller'. Would you like to see the contact details for any of them? ``` **Prompt:** ``` Check who is out of the office this week. ``` **Response:** ``` Retrieving leave data... There are 3 employees out this week: 'Maria Garcia' (Vacation until Friday), 'John Doe' (Sick leave), and 'Elena Rossi'. Should I check the pending approval tasks for their replacements? ``` **Prompt:** ``` Show my open HR tasks and complete ID 'task_992'. ``` **Response:** ``` Task list retrieved! You had 5 open items. I have successfully marked 'task_992' (Onboarding Check) as completed. You now have 4 tasks remaining. Would you like me to list them? ``` ## Capabilities ### Locate and profile employees Search for specific staff members using detailed filters or pull basic contact information across the entire company. ### Manage leave status and requests Check current employee leave balances, identify who is out of the office, or submit new time off requests. ### Handle payroll and compensation data Retrieve historical payroll records and access detailed salary and benefit information for any staff member. ### Oversee company tasks and onboarding List all open HR tasks, mark them as complete, or send welcome invitations to new hires. ## Use Cases ### Auditing a team's time-to-hire compliance An HR Manager needs to confirm if all new hires completed their mandatory onboarding steps. They ask their agent to list_open_tasks, identify overdue items, and then use search_employees to find the associated employee records for follow-up. ### Processing a leave request mid-meeting A Team Lead gets asked about coverage. They prompt their agent to get_whos_out for the next three weeks, then use get_leave_balance on key team members to confirm available PTO. ### Investigating a pay discrepancy A manager notices an employee's compensation might be wrong. They immediately prompt their agent to get_employee_compensation and cross-reference it with historical payroll data using get_payroll_history for accuracy. ### Handling mass new hires efficiently The Operations Leader has 15 people starting next month. They use invite_employee to trigger the welcome workflow, then run list_public_profiles to build a master contact sheet instantly. ## Benefits - You get real-time visibility into team availability. Instead of manually checking who is out using a separate calendar tool, you ask your agent to run get_whos_out for any date range, giving instant status updates. - Payroll data becomes conversational. You don't need to export files or navigate complex reports; simply prompt your agent for the get_payroll_history and compensation details for deep financial insight. - Onboarding is streamlined. When a new person starts, you can use invite_employee to send the welcome package, while simultaneously using search_employees to gather their full profile data into one place. - Task management moves at the speed of thought. You can list all outstanding items with list_open_tasks and then immediately mark an item as done by calling complete_task—all in a single chat session. - Time off requests are effortless. Need to approve leave? Use get_leave_balance to check remaining time, or use request_time_off to submit the actual request for approval. ## How It Works The bottom line is: you talk to the system like talking to a people operations specialist, and it executes complex HR queries behind the scenes. 1. Subscribe to the HiBob MCP and enter your Service User API Token. 2. Connect this MCP to your preferred AI client (Claude, Cursor, etc.) via Vinkius. 3. Use natural language prompts within your chat interface to execute HR actions. ## Frequently Asked Questions **Can HiBob MCP track who was on leave using the get_whos_out tool?** Yes, it can. You ask for a date range, and your agent returns a list of all employees currently marked as out of office. **How do I submit a time off request with HiBob MCP?** You use the request_time_off tool by providing the policy type, start date, and end date in your prompt. The agent handles submitting the official request. **Does search_employees allow me to filter for specific roles?** Yes, you can pass detailed JSON filters into the search_employees tool. This allows you to find employees based on criteria beyond just department or name. **What kind of payroll data does get_payroll_history provide?** It retrieves the platform's historical payroll records. This means you can see compensation details over time for auditing purposes. **Can I use HiBob MCP to mark a task as complete?** Absolutely. You first list all open tasks using list_open_tasks, and then you call complete_task on the specific ID to clear it from your pending items.