# MyHR MCP > MyHR connects your AI agent directly to employee records for New Zealand and Australia compliance. Use this MCP to automatically manage timesheets, process leave requests, and pull detailed employee profiles through natural conversation. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** employee-management, leave-tracking, timesheets, hr-compliance, workforce-management ## Description Managing human resources is messy work. You shouldn't have to remember which department holds the current absence data or how to manually cross-reference a team member’s employment status against their time off balance. This MCP lets your AI client handle all that complexity using simple chat commands. It gives you full access to employee details, letting you list profiles, check departmental structures, and track historical timesheets without ever opening the web portal. Need someone out for a week? You can initiate an absence request right through your agent. Want to onboard a new team member? Create their record instantly. Because this MCP lives on Vinkius, it provides a single gateway to all major HR systems, making sure that whether you’re using Claude or Cursor, the data is always fresh and ready for action. ## Tools ### create_absence_request Submits a new request for an employee's paid or unpaid leave. ### create_employee Adds a brand-new staff member profile to the company directory. ### get_employee_details Retrieves all specific information for one employee using their ID or name. ### list_absences Shows a comprehensive list of current and past leave requests for the organization. ### list_departments Pulls a full, up-to-date list of all operational departments within the company. ### list_employees Generates a directory listing of every employee currently registered in MyHR. ### list_gender_options Lists all accepted gender options for employee profiles. ### list_marital_statuses Retrieves the predefined list of marital status choices used in the HR system. ### list_offices Lists all physical office locations associated with the company staff. ### list_timesheets Retrieves a summary of logged work hours for a specified time period. ## Prompt Examples **Prompt:** ``` List all employees and show their departments. ``` **Response:** ``` Employees: 12. Engineering: 5. Marketing: 3. Sales: 2. HR: 1. Finance: 1. Most recent hire: Sarah Chen (Engineering, joined Apr 15). ``` **Prompt:** ``` Create an absence request for employee 42 next Monday. ``` **Response:** ``` Absence created ✅. Employee #42. Type: Vacation. Start: Apr 28. End: Apr 28. Status: Pending approval. ``` **Prompt:** ``` Show timesheets and current absence requests. ``` **Response:** ``` Timesheets: 45 entries this week. Total hours logged: 360h. Absences: 3 pending. 1) Mike L. — Vacation (May 1-5). 2) Lisa R. — Sick (Apr 25). 3) Tom K. — Personal (Apr 30). ``` ## Capabilities ### Retrieve employee records Get detailed profiles for staff members by searching existing employee lists. ### Track team absences View a list of all current and upcoming leave requests for your workforce. ### Submit time off requests Create formal absence records to submit leave for approval within the system. ### Review payroll hours Browse and compile historical timesheet entries for specific employees or groups. ### Manage company structure data List and configure foundational HR elements like departments, offices, or job titles. ## Use Cases ### Manager needs to check team availability for a project kickoff. The manager asks their agent: 'Who is out next month?' The agent uses `list_absences` and consolidates the data, providing an immediate view of who's unavailable so scheduling can proceed. ### HR Specialist needs to onboard a new executive. The specialist prompts: 'Create a profile for John Doe in Finance.' The agent handles this by calling `create_employee`, ensuring the record is immediately available and compliant with company structure rules. ### Payroll Coordinator needs to verify hours worked last month. The coordinator asks: 'Show me all timesheets for the Sales department in April.' The agent calls `list_timesheets`, giving them a comprehensive, verified summary of logged work hours. ### HR Specialist needs to audit company structure data. The specialist asks: 'What departments do we currently have?' The agent runs `list_departments`, ensuring that the internal records match the physical reality of the business units. ## Benefits - Get instant headcount reports. Instead of manually querying a database, you can use the `list_employees` tool to generate a complete directory listing in seconds. - Streamline onboarding for new staff. You can trigger the `create_employee` function right from your agent, building out profiles without ever logging into the HR portal. - Stay compliant with leave tracking. Need to check if an employee has enough days remaining? Use the `list_absences` tool to track their full history and current requests instantly. - Simplify payroll verification. The `list_timesheets` tool lets you pull all logged hours for a team or individual, making payroll prep faster and reducing manual errors. - Maintain clean data structures. By listing options using tools like `list_departments`, your agent ensures any new record follows the correct organizational taxonomy. ## How It Works The bottom line is that your AI client acts like an expert HR assistant sitting right next to you, handling all the necessary data lookups so you don't have to click through five different tabs. 1. Connect your preferred AI client to the MyHR MCP via Vinkius. You don't need API keys; you just connect. 2. Tell your agent exactly what you need—for example, 'Show me all employees in Marketing' or 'Create a leave request for Mike next week.' 3. The agent uses the underlying tools to fetch the live data from MyHR and presents it back to you instantly, formatted as plain text. ## Frequently Asked Questions **How do I list employees using MyHR MCP?** You ask your agent to 'list all current staff.' The system uses the `list_employees` tool to give you a comprehensive directory of every person registered in the HR database. **Can I submit a leave request using MyHR MCP?** Yes, simply tell your agent to create an absence request. It handles this by calling `create_absence_request` and submits it for review within the system. **How do I check historical timesheets with MyHR MCP?** Just ask the agent to list timesheets, specifying the date range. The tool uses `list_timesheets` to compile all logged hours for you in one view. **Does MyHR MCP let me add a new department?** The MCP lets you manage the data *about* departments, such as listing them via `list_departments`. If you need to physically change the structure, check your HR system's admin tools. **What if I need employee details for a specific person?** Use the agent and ask for the specifics by calling `get_employee_details`. You just need to provide the name or ID, and the full record appears immediately.