MCP App Store
by KeenEthics
HR Omni icon

HR Omni MCP Server for ChatGPT

By HR Omni Solutions

Overview

HR Omni helps growing organisations keep employee information in one place, spend less time on manual admin and follow the same HR processes across the business. Teams can find the information they need while controlling who can see sensitive employee data. Use this app to find out whether HR Omni meets your needs and how it can support your day-to-day work. If your company already uses HR Omni, connect your account to ask questions about information you are allowed to see or complete supported tasks in ChatGPT. What you can see or do depends on your access, the HR Omni products your company uses and the actions available through the connection.

How to connect

  1. ChatGPT: Open the HR Omni listing in the ChatGPT app directory and choose Connect. ChatGPT listing HR Omni exposes 12 tools here.

Tools

get_company_details

ChatGPT
Returns the details of one HR Omni company. Use after get_my_access_context has resolved the intended company to companyId and the user asks about that company's own record. This is company-level organisation data and requires access to the company plus relevant organisation permissions. It does not return departments, modules, employees, reporting relationships, or leave data. Do not use for the authenticated user's profile, product-wide information, or another company the user cannot access.

get_company_holidays

ChatGPT
Returns the configured company holidays and non-working days for one company, optionally filtered by year. Use when checking which configured dates affect working-day or leave calculations. These are HR Omni company settings, not a legal determination of public holidays. Leave Management must be enabled and the user must have access to the company with relevant leave permissions. Year defaults to the current calendar year and must be from 2010 through 2040; convert relative periods such as "next year" to an explicit YYYY. Do not use for a user's leave balance, leave requests, working schedule, or product capability questions.

get_my_access_context

ChatGPT
Returns the authenticated user's HR Omni profile, accessible companies, and access-control role identifiers for each company. Use first to identify the user, resolve a company name to companyId, or understand available company contexts before calling a company-scoped action. It takes no arguments and operates only on the authenticated user; roles are included because organisation access is granted. Company access and roles can differ by company, and role names must not be used to infer permission for another action because HR Omni checks every request. Do not use for detailed company, employment, module, organisation-chart, or leave data.

get_my_employment

ChatGPT
Returns the authenticated user's current employment record for one company, or null when no employment record exists. Use for questions about the user's own department, manager, employment type, role, dates, or working schedule. This is self-only and requires access to the company plus relevant organisation permissions. Organisational roles describe the employment relationship and must not be treated as access-control roles. Do not use for another employee, company-wide organisation structure, historical employment events, or leave information.

get_my_leave_summary

ChatGPT
Returns the authenticated user's leave summary for one company and optional year. Use for questions such as "what is my leave balance?", "how much holiday do I have?", or "how many days have I booked?" The response reports annual allowance, booked leave, requested leave, and carry-over days taken as separate values; do not combine booked and requested leave. This is self-only and should be preferred over company-wide leave actions for personal questions. Leave Management must be enabled and the user must be enrolled with active employment and a working schedule. Year defaults to the current calendar year; convert relative periods such as "last year" to an explicit YYYY. Do not use for leave history, individual request details, other employees, or product capability questions.

get_org_chart

ChatGPT
Returns the current organisation chart for one company, optionally limited to a department. Use for questions about current manager and reporting relationships across the company or within a department. This is company-wide organisation data and requires access to the company plus relevant organisation permissions; resolve a human department name with list_company_departments before passing departmentId. The chart reflects current employment relationships, and people without a manager may appear at the company root. Do not use for historical structures, access-control permissions, employment details for only the authenticated user, or leave data.

list_company_departments

ChatGPT
Lists departments for one company and returns their IDs and names, collecting bounded paginated results. Use to resolve a human department name to departmentId before a department-filtered organisation-chart or company-leave request. This is company-wide organisation data and requires access to the company plus relevant organisation permissions. The optional search accepts keywords; add * to a keyword for prefix matching. Do not use as an employee directory, for reporting relationships, for access-control permissions, or to create or change departments.

list_company_leave_requests

ChatGPT
Lists company-wide leave requests for one company, with optional year, month, status, and department filters. Use when the user asks about other employees, a department, or company-wide leave; prefer list_my_leave_requests for "show my leave". Leave Management must be enabled, and HR Omni enforces company permissions plus approver or administrator scope. Year defaults to the current calendar year, omitted month includes all months, and omitted status includes all statuses. Convert relative periods such as "this month" to explicit year and month values. Status accepts a comma-separated selection of SUBMITTED, AUTO_APPROVED, APPROVED, CANCELLED, and DECLINED. Resolve a human department name with list_company_departments before passing departmentId. Do not use for personal leave balances or to submit, approve, or reject requests. If access or company context is rejected, surface that result rather than retrying with broader data.

list_company_modules

ChatGPT
Lists HR Omni modules for one company and whether each is enabled. Use to answer whether a module, such as Leave Management, exists or is enabled before calling a module-dependent action. This is company-level configuration and requires access to the company plus relevant organisation permissions. An enabled module does not prove that the user has permission to use every action in it. Do not use for product-wide capability questions, personal enrolment or entitlement, module data, or changing module settings.

list_leave_types

ChatGPT
Lists the leave types configured for one company, returning each type's ID, name, and colour. Use to answer which leave types are available or to resolve a leaveTypeId before preparing a leave request. This is company configuration data, not a personal leave balance. Leave Management must be enabled and the user must have access to the company with relevant leave permissions. Do not use to determine whether Leave Management is enabled; use list_company_modules for that. Do not use to submit, approve, or reject a request.

list_my_leave_requests

ChatGPT
Lists the authenticated user's own leave requests for one company, with optional year, month, and status filters. Use for questions such as "show my leave", leave history, request status, or checking whether a submission already exists. This is self-only and should be preferred over list_company_leave_requests for personal questions. Leave Management must be enabled and the user must be enrolled. Year defaults to the current calendar year, omitted month includes all months, and omitted status includes only APPROVED and AUTO_APPROVED. Convert relative periods to explicit year and month values. Status accepts a comma-separated selection of SUBMITTED, AUTO_APPROVED, APPROVED, CANCELLED, and DECLINED. After an ambiguous submission, specify the same year and month plus all five statuses so a pending request is not missed. Do not use for leave allowance or remaining-balance questions, other employees, or approving or rejecting requests.

submit_my_leave_request

ChatGPT
Submits a leave request for the authenticated user in one company and changes HR Omni data. Use only when the user intends to create a request, not when asking whether dates would work. Leave Management must be enabled and the user must be enrolled with active employment and a working schedule. Resolve the company, leave type, exact dates, half-day or full-day boundaries, and optional message first, converting natural dates such as "next Friday" to YYYY-MM-DD. Working schedules and configured non-working days affect leave consumption, overlapping requests are rejected, and the leave type determines whether a valid request is submitted or auto-approved. Call only after the user explicitly confirms the final values. This operation is self-only, non-idempotent, and attempted once. Do not use for another employee or to approve or reject a request. Do not report success until this action succeeds; if the result is ambiguous, call list_my_leave_requests for the same year and month with status SUBMITTED,AUTO_APPROVED,APPROVED,CANCELLED,DECLINED before any retry.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/hr-omni"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/hr-omni)