What can I do after connecting my ChatGPT, Claude or Cursor to Omni HR?

Modified on Mon, 20 Jul at 11:32 AM

Overview:

Once you're connected, you can talk to your AI assistant (ChatGPT, Claude or Cursor) in plain English and it'll handle Omni HR tasks behind the scenes. Things like:

Finding employees and checking their profiles
Looking up reporting lines and organisation structure
Updating employee information
Running promotions, transfers, rehires, or terminations
Submitting time off requests on someone's behalf
Adjusting time off balances and entitlements
Checking who's out over a date range

You don't need to learn any special commands — just ask for what you want.

Important Notice:

This is an early version of MCP, so things may still be evolving.

Want access? Just email us at support@omnihr.co or reach out to your account manager — access isn't automatic and depends on your subscription's eligibility.

TABLE OF CONTENTS

What tools are currently supported?
What tools are currently not supported?
Sample prompts

What tools are currently supported?

We currently support People & Time off tools.

People data & employee lifecycle

Tool	What it does
`get_employee_profile_data`	Search for employees and view their profiles — personal info, job details, employment history, probation, addresses, emergency contacts, dependents, ID information, bank accounts, manager history, work schedule, holiday calendar, and reporting lines.
`get_employee_custom_sections*`	View organisation-defined custom sections and field values for an employee, including the available options for any custom select or multi-select fields.
`list_employee_options`	Look up valid dropdown and reference values — departments, teams, locations, nationalities, phone codes, states, work schedules, holiday calendars, and other preset options.
`update_employee_profile`	Update preset employee profile fields — change an emergency contact, update an address, assign a new work schedule or holiday calendar, and more.
`update_employee_custom_fields*`	Update organisation-defined custom field values for an employee.
`employee_job_change`	Run promotions, transfers, job changes, and rehires with proper effective dates.
`terminate_employee`	Process employee terminations, including reassigning direct reports.

*This excludes the Job Section custom fields

Time off

This tools are three pronged; submitting a request on an employee's behalf, adjusting an employee's balance or entitlement, and answering "who's out" questions.

Tool	What it does
`get_whos_out`	Check who is on leave over a date range. Filter by department, location, position, team, direct/indirect reports, or the whole company.
`list_employee_time_off_types`	View all time off types available to an employee, along with their current balances (entitlement earned, taken, planned, available).
`list_employee_time_off_type_detail`	View detailed information for a specific time off type, including individual entitlements and their usage periods.
`submit_time_off_request_on_behalf`	Submit a time off request on an employee's behalf — full day, half day (AM/PM), or quarter day, with remarks and attachments.
`upload_time_off_attachment`	Upload a supporting document (e.g. medical certificate) to attach to a time off request.
`adjust_time_off_balance`	Add or deduct days from an employee's time off balance for a custom time off type, with an optional expiry date and remarks.
`adjust_time_off_entitlement`	Adjust the duration or usage period of a specific entitlement for ad-hoc or preset time off types.

What tools are currently not supported?

Compensation and payroll data
Job Section Custom Fields
ATS
Goals and Performance
Document management
Attendance
Expenses
Onboarding Workflows
Adding employees
Editing or deleting existing job or employment records
Editing or modifying a termination record

For these, use the Omni HR web app directly.

Sample prompts

Not sure what to ask? Here are examples grouped by what you're trying to do. Copy-paste any of these into your AI chat, swapping in real names and dates.

Getting Omni HR's attention. Sometimes your assistant will answer from its own general knowledge instead of actually reaching into Omni HR — most likely when you've got a few other tools connected and it isn't sure which one you mean. 

Easy fix: start your message by greeting it with the name you gave the connection during setup. Named it Omni HR? Open with "Hi OmniHR, find Alice Tan." Called it something else? Use that — "Hi Robin, who's off next week?" Once it's reached into Omni HR in that chat, you can drop the greeting and just keep asking.

Use Case(s)	Sample Prompts
Finding employees & checking profiles	"Find Alice Tan." "Show engineers hired in the last 6 months." "List employees in Singapore." "Who does Alice report to?" "Show Alice's job and manager history."
Custom fields	"Show Alice's education background." "What are the IT devices Alice have?" "Set Alice's dietary preference to vegetarian" "Update Alice's T-shirt size from L to M."
Updating employee profiles	"Update Alice's work schedule." "Update Alice's emergency contact to John Tan, +65 9123 4567." "Change Alice's confirmation date to today."
Promotions, transfers & job changes	"Promote Alice to Senior Engineer." "Transfer Alice to the Singapore team." "Rehire Alice."
Terminations	"Terminate Alice on 30 June 2026." "Terminate the 3 contract employees by end of this month."
Bulk updates	"Update the work schedule for everyone in the Jakarta office to the new Ramadan schedule."
Time off — checking balances & types	"What time off types does Alice have?" "How much annual leave does Alice have left?" "Show Alice's childcare leave entitlements."
Time off — submitting requests on behalf	"Submit 2 days of annual leave for Alice from 14 July to 15 July." "Apply a half-day sick leave for Bob on Monday 14 June AM."
Time off — adjusting balances & entitlements	"Add 3 days to Alice's annual leave balance." "Adjust Alice's childcare leave entitlement to 10 days."
Who's out?	"Who's off next week?" "Who's on leave in Engineering this month?" "Anyone out today?" "Who's out from the Singapore office?" "Any Product Managers on leave this week?" "Who on my team is off this week?" "Any of my direct reports on leave next month?"

Still Need Help?:

Reach out to our support team should you need further assistance.