# UKG Pro MCP connector

The UKG Pro connector brings accruals, code tables, audit details and business rule imports to Claude, ChatGPT, Cursor, Microsoft Copilot and the Elaichi Agent, with each person signed in as themselves and every call logged.

Source: https://elaichi.ai/connectors/ukgpro/

## Facts

| | |
| --- | --- |
| Application | UKG Pro |
| Category | HRIS |
| AI tools | 200 |
| Authentication | Connects with an API key |
| Bring your own OAuth app | No |
| MCP endpoint | https://api.elaichi.ai/mcp |
| Works with | Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client, and the Elaichi Agent |
| Tools advertised by name | No. Connected tools are never listed one by one, however few there are. The endpoint advertises `search_tools` and `execute_tool` instead |

## What you can ask once UKG Pro is connected

- Create a floating holiday accrual for the Denver warehouse staff.
- List this week's audit details for changes to COBRA status codes.
- Add a service milestone entry to the award type code table.

## Connect UKG Pro in Elaichi

This happens once for the organization, before any client is involved.

1. Open Connections, choose Add connection, and pick UKG Pro.
2. Optionally set Share with, then press Connect.
3. Paste an UKG Pro API key. One person generates a token in UKG Pro and pastes it once. Everyone else works through Share with, and never sees it.

Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which UKG Pro tools are exposed, rename them, or freeze arguments before anyone points a client at it.

## UKG Pro MCP connector for Claude

Endpoint: https://api.elaichi.ai/mcp

1. Open Customize, then Connectors.
2. Press Add.
3. Name it, paste the MCP server URL, then Continue.
4. Sign in and approve.

On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves.

## UKG Pro MCP connector for Claude Code

Endpoint: https://api.elaichi.ai/mcp

1. In a terminal, run `claude mcp add` with the endpoint.
2. Start Claude Code and run `/mcp`.
3. Pick elaichi, then sign in and approve in the browser.

```bash
claude mcp add --transport http elaichi --scope user https://api.elaichi.ai/mcp
```

Use `--scope project` instead to share it with the repository through `.mcp.json`.

## UKG Pro MCP connector for ChatGPT

Endpoint: https://api.elaichi.ai/mcp

1. Open Plugins, then press the + button.
2. Name it and paste the endpoint into Server URL.
3. Leave Authentication on OAuth, then tick the risk acknowledgement.
4. Press Create, then sign in and approve.

Works on the web. The plugin directory lives at chatgpt.com/plugins.

## UKG Pro MCP connector for Cursor

Endpoint: https://api.elaichi.ai/mcp

1. Open `~/.cursor/mcp.json`.
2. Add the endpoint under `mcpServers`.
3. Reload Cursor, then sign in and approve.

Set up per machine, so repeat it on each computer you work from.

## UKG Pro MCP connector for Microsoft Copilot

Endpoint: https://api.elaichi.ai/mcp

1. In Copilot Studio, open your agent, then Tools, Add a tool, New tool and Model Context Protocol.
2. Paste the endpoint into Server URL, choose OAuth 2.0, then Dynamic discovery, and press Create.
3. Create a new connection, sign in and approve, then press Add to agent.
4. Under Channels, open Teams and Microsoft Copilot and make the agent available in Microsoft Copilot.

Microsoft Copilot was called Microsoft 365 Copilot. Keep the tool on end-user credentials, so each person signs in as themselves.

## Connect UKG Pro to any MCP client

Endpoint: https://api.elaichi.ai/mcp

1. Add the endpoint as a remote MCP server.
2. Sign in and approve.

The Elaichi Agent already has these tools, with nothing to set up.

## What the consent screen decides

Every scope the client asks for starts ticked except "Delete things", which you tick yourself. Calling a UKG Pro tool needs "Use your connected apps". Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Think hard before granting Use your connected apps, which can also delete in connected apps and cannot be undone.

## What teams do with UKG Pro through Elaichi

### Set up a new accrual without opening UKG Pro

HR. Tell the agent the accrual you need, such as a floating holiday balance for a new site, and it creates the accrual in UKG Pro while you stay in the conversation.

### Clean up accruals that should not exist

Payroll. Ask which accrual was entered by mistake and have it removed by ID, with the deletion recorded against your name in the audit log.

### Keep COBRA status codes current

Benefits. List the COBRA status codes in UKG Pro, add a missing one, or correct a label, all from a short ask rather than a trip through the code table screens.

### Maintain code tables in plain language

HR operations. Add an allergy code, an award type, or a career provider to the right UKG Pro code table, and update an existing entry when a name changes.

### Answer who changed what, and when

Compliance. Pull the UKG Pro audit details for a date range or a record and get a readable summary before an internal review or an auditor's question.

### Push a business rule import through

HR systems. Upload the file, start the transaction, and check the file status and transaction status in UKG Pro without waiting on someone with admin screens open.

## Elaichi vs Zapier MCP vs Composio for UKG Pro

All three can connect UKG Pro to an AI assistant, and all three have admin controls. They differ in where access lives and how you pay.

| What to check | Elaichi | Zapier MCP | Composio |
| --- | --- | --- | --- |
| Where the AI connects | One address for the whole organization. Endpoint: https://api.elaichi.ai/mcp | A server per member, created at sign-in. | An MCP endpoint per team, or an SDK. |
| Control over UKG Pro tools | Allow or restrict single UKG Pro tools, per role or user. | App and action restrictions on the account. | Role permissions, down to the action. |
| Record of calls | One audit entry per UKG Pro call. | A History tab of tool calls. | A log of every tool call. |
| Single sign-on | SAML or OIDC, plus SCIM, on Gold. | SAML on Enterprise. | SAML and OIDC on Enterprise. |
| Price | Free for one person; $15 per user per month on Gold. | 2 tasks per successful call. | Billed per tool call. |

Sources: Zapier MCP [docs](https://docs.zapier.com/mcp/get-started/quickstart), [security](https://docs.zapier.com/mcp/manage/security), [usage](https://docs.zapier.com/mcp/features/usage); Composio [docs](https://docs.composio.dev/docs/composio-connect), [gateway](https://composio.dev/mcp-gateway), [enterprise](https://composio.dev/enterprise), [pricing](https://composio.dev/pricing). Checked September 2026.

Longer take: [Zapier MCP alternative](/blog/zapier-mcp-alternative/) and [when you don't need an MCP gateway](/blog/when-you-dont-need-an-mcp-gateway/).

## Frequently asked questions

### How do I connect UKG Pro to Claude?

Connect UKG Pro in Elaichi first, then paste https://api.elaichi.ai/mcp into Claude under Customize, then Connectors, then Add. UKG Pro's own sign-in step asks for an API key from your UKG Pro account, and that is all it needs. There is no OAuth application to register and no client ID or secret to generate.

### Does UKG Pro work with ChatGPT and Cursor as well as Claude?

Yes. Once UKG Pro is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, Microsoft Copilot, any MCP client and the Elaichi Agent. You connect UKG Pro once and every client picks it up.

### What can an AI agent actually do with my UKG Pro data?

An agent can create or remove an accrual in UKG Pro, list and add entries in code tables such as allergy, award type, career provider, child support type and COBRA status, pull audit details for a period, and run a business rule import from file upload through to checking its status. Short, concrete asks work best, such as naming the code table and the entry you want rather than describing a whole project in one sentence.

### Does connecting UKG Pro give the AI access to everything in it?

No. Every call to UKG Pro through Elaichi runs as the person who signed in, so the agent sees only the accruals, code tables and audit details that person could already reach in UKG Pro. Elaichi can narrow that access further with roles and restrictions, and it can never widen it.

### Can my team share one UKG Pro connection?

Yes. One person connects UKG Pro in Elaichi and shares the connection with a team, and nobody else ever handles the API key. Each teammate still signs in as themselves, so the audit log names the person behind every change to an accrual or code table.

### Can I stop an agent from deleting or changing things in UKG Pro?

Yes. Restrictions in Elaichi work per action, so you can restrict deleting UKG Pro accruals or updating code tables for a role or for one person while leaving listing and lookups open. A restricted tool still appears in Elaichi's tool search, flagged as restricted, but no client can run it, whatever the prompt says.

### What happens to a UKG Pro connection when someone leaves?

Offboarding that person in Elaichi ends their access to UKG Pro through every client at once. A shared UKG Pro connection keeps working for everyone else on the team. If you want the connection gone altogether, disconnecting UKG Pro once in Elaichi removes it from Claude, ChatGPT, Cursor, Microsoft Copilot and every other client.

### Does the UKG Pro MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. UKG Pro is reached over the same MCP endpoint every client uses, so anything that speaks MCP can call it — Gemini, Codex, Claude Code, Windsurf, Cline, Zed and OpenCode among them — alongside Claude, ChatGPT, Cursor, Microsoft Copilot, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

### Is Elaichi an alternative to Zapier MCP for UKG Pro?

Yes. Both let Claude, ChatGPT or Cursor use UKG Pro. Zapier MCP fits a team that already automates in Zapier, since each person signs in and acts as themselves in that account. Elaichi fits when IT wants one address for the whole company, per-tool rules by role, and a record of every UKG Pro call.

### How is Elaichi different from Composio for UKG Pro?

Composio gives AI agents tools and sign-in handling across 1,000+ apps, for developers building agents or people using an assistant, billed per tool call. Elaichi gives a company's own people governed access to UKG Pro: one address, restrictions per role or user, and $15 per user per month. Both have role permissions and a log of every call.

## All 200 UKG Pro tools

Every tool below is callable through https://api.elaichi.ai/mcp once UKG Pro is connected, subject to the toolbox it is in and the restrictions on the caller.

- **Create a UKG Pro accrual** (Create). Import Accruals Information. Imports Accruals information into the Accruals staging table in UKG Pro. Sends the Primary Company Code as US-Client-Id. Required: body.
- **Delete a UKG Pro accrual by ID** (Delete). Delete Accrual by Batch ID. Deletes data by Batch ID from the Accruals staging table in UKG Pro. The id is the batchId. Sends the Primary Company Code as US-Client-Id. Required: id.
- **Delete a UKG Pro accruals accrual by ID** (Delete). Delete Accrual by Batch ID and Source ID. Deletes data by Batch ID and Source ID from the Accruals staging table table in UKG Pro. The id is the sourceId. Sends the Primary Company Code as US-Client-Id. Required: id, batch_id.
- **List all UKG Pro audit details** (List). Get Audit Details Data. Needs the View role on the Personnel Integration web service. Required: startDateTime, endDateTime, tableName, fieldName.
- **Get single UKG Pro businessruleimport tool filestatus by ID** (Get). Retrieve Business Rule Import Tool Transaction Status by File ID. Uses the File ID to fetch the Business Rule Import Tool Transaction Status. The id is the fileId. Required: id.
- **Create a UKG Pro businessruleimport tool fileupload** (Create). Takes an XML transaction and feeds it into the Business Rule Import Tool. Submits an encoded XML transaction to the Business Rule Import Tool.
- **Create a UKG Pro businessruleimport tool transaction** (Create). Takes an XML transaction and feeds it into the Business Rule Import Tool (Staging). Submits an encoded XML transaction to the Business Rule Import Tool (Staging).
- **Get businessruleimport tool transactionstatus by ID** (Get). Retrieve Business Rule Import Tool Transaction Status by Staging ID. Uses the Staging ID to fetch the Business Rule Import Tool Transaction Status. The id is the stagingId. Required: id.
- **List all UKG Pro code tables** (List). Get Code Tables information. UKG Pro HCM codes table lookup, will contain a list of all tables with HATEOAS links to make a subsequent call to get all the codes for that table. Needs the View role on the Company Configuration Integration web service.
- **Create a UKG Pro code table** (Create). Post Code Tables information. Creates a new UKG Pro HCM Code table configuration, Array of objects is permitted for multi-records support. Needs the Add role on the Company Configuration Integration web service. Required: body.
- **List all UKG Pro code tables allergy** (List). Retrieve all allergy configurations. Returns information about the UKG Pro HCM allergy configurations.
- **Create a UKG Pro code tables allergy** (Create). Create a new allergy configuration. 'Creates a new UKG Pro HCM allergy configuration.' Required: code, description.
- **Update a UKG Pro code tables allergy by ID** (Update). Update a single allergy configuration. Provides the ability to update a single allergy configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables award type** (List). Retrieve all awardType configurations. Returns information about the UKG Pro HCM awardType configurations.
- **Create a UKG Pro code tables award type** (Create). Create a new awardType configuration. 'Creates a new UKG Pro HCM awardType configuration.' Required: code, description.
- **Update a UKG Pro code tables award type by ID** (Update). Update a single awardType configuration. Provides the ability update a single awardType configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables career provider** (List). Retrieve all careerProvider configurations. Returns information about the UKG Pro HCM careerProvider configurations.
- **Create a UKG Pro code tables career provider** (Create). Create a new careerProvider configuration. 'Creates a new UKG Pro HCM careerProvider configuration.' Required: code, description.
- **Update a UKG Pro code tables career provider by ID** (Update). Update a single careerProvider configuration. Provides the ability update a single careerProvider configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables child support type** (List). Retrieve all childSupportType configurations. Returns information about the UKG Pro HCM childSupportType configurations.
- **Create a UKG Pro code tables child support type** (Create). Create a new childSupportType configuration. 'Creates a new UKG Pro HCM childSupportType configuration.' Required: code, description.
- **Update a UKG Pro code tables child support type by ID** (Update). Update a single childSupportType configuration. Provides the ability update a single childSupportType configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables cobra status** (List). Retrieve all cobraStatus configurations. Returns information about the UKG Pro HCM cobraStatus configurations.
- **Create a UKG Pro code tables cobra status** (Create). Create a new cobraStatus configuration. 'Creates a new UKG Pro HCM cobraStatus configuration.' Required: code, description.
- **Update a UKG Pro code tables cobra status by ID** (Update). Update a single cobraStatus configuration. Provides the ability update a single cobraStatus configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables company property** (List). Retrieve all companyProperty configurations. Returns information about the UKG Pro HCM companyProperty configurations.
- **Create a UKG Pro code tables company property** (Create). Create a new companyProperty configuration. 'Creates a new UKG Pro HCM companyProperty configuration.' Required: code, description.
- **Update a UKG Pro code tables company property by ID** (Update). Update a single companyProperty configuration. Provides the ability update a single companyProperty configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables course category** (List). Retrieve all courseCategory configurations. Returns information about the UKG Pro HCM courseCategory configurations.
- **Create a UKG Pro code tables course category** (Create). Create a new courseCategory configuration. 'Creates a new UKG Pro HCM courseCategory configuration.' Required: code, description.
- **Update a UKG Pro code tables course category by ID** (Update). Update a single courseCategory configuration. Provides the ability update a single courseCategory configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables course delivery met** (List). Retrieve all courseDeliveryMet configurations. Returns information about the UKG Pro HCM courseDeliveryMet configurations.
- **Create a UKG Pro code tables course delivery met** (Create). Create a new courseDeliveryMet configuration. 'Creates a new UKG Pro HCM courseDeliveryMet configuration.' Required: code, description.
- **Update a UKG Pro code tables course delivery met by ID** (Update). Update a single courseDeliveryMet configuration. Provides the ability update a single courseDeliveryMet configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables course sub category** (List). Retrieve all courseSubCategory configurations. Returns information about the UKG Pro HCM courseSubCategory configurations.
- **Create a UKG Pro code tables course sub category** (Create). Create a new courseSubCategory configuration. 'Creates a new UKG Pro HCM courseSubCategory configuration.' Required: code, description.
- **Update a UKG Pro code tables course sub category by ID** (Update). Update a single courseSubCategory configuration. Provides the ability update a single courseSubCategory configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables disability** (List). Retrieve all disability configurations. Returns information about the UKG Pro HCM disability configurations.
- **Create a UKG Pro code tables disability** (Create). Create a new disability configuration. 'Creates a new UKG Pro HCM disability configuration.' Required: code, description.
- **Update a UKG Pro code tables disability by ID** (Update). Update a single disability configuration. Provides the ability update a single disability configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables employee type** (List). Retrieve all employeeType configurations. Returns information about the UKG Pro HCM employeeType configurations.
- **Create a UKG Pro code tables employee type** (Create). Create a new employeeType configuration. 'Creates a new UKG Pro HCM employeeType configuration.' Required: code, description.
- **Update a UKG Pro code tables employee type by ID** (Update). Update a single employeeType configuration. Provides the ability update a single employeeType configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables job family** (List). Retrieve all jobFamily configurations. Returns information about the UKG Pro HCM jobFamily configurations.
- **Create a UKG Pro code tables job family** (Create). Create a new jobFamily configuration. 'Creates a new UKG Pro HCM jobFamily configuration.' Required: code, description.
- **Update a UKG Pro code tables job family by ID** (Update). Update a single jobFamily configuration. Provides the ability update a single jobFamily configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables license type** (List). Retrieve all licenseType configurations. Returns information about the UKG Pro HCM licenseType configurations.
- **Create a UKG Pro code tables license type** (Create). Create a new licenseType configuration. 'Creates a new UKG Pro HCM licenseType configuration.' Required: code, description.
- **Update a UKG Pro code tables license type by ID** (Update). Update a single licenseType configuration. Provides the ability update a single licenseType configuration. The id is the code. Required: id, code, description.
- **List all UKG Pro code tables loan type** (List). Retrieve all loanType configurations. Returns information about the UKG Pro HCM loanType configurations.
- ...and 150 more tools. Call `tools/list` via the MCP endpoint, or see the full catalog via the API, for the complete set.
