Skip to content

Humi by Employment Hero MCP connector

The Humi by Employment Hero connector lets Claude, ChatGPT, Cursor and the Elaichi Agent look up employees, time off requests and additional incomes, and log hours worked, with each person acting under their own Humi access.

  • How it connects. Connects with an API key. The credential goes into a vault nobody reads back.

  • One address. https://api.elaichi.ai/mcp, the same for every user.

  • Their own access. An agent never gets more than the person it acts for.

How to connect

How to connect Humi by Employment Hero to Claude, ChatGPT or Cursor

Two steps, about a minute.

1

In Elaichi

Connect Humi by Employment Hero once

  1. Open Connections, choose Add connection, and pick Humi by Employment Hero.

  2. Optionally set Share with to give a team access, then press Connect.

  3. Paste a Humi by Employment Hero API key. One person generates a token in Humi by Employment Hero and pastes it once. Everyone else works through Share with, and never sees it.

The credential is vaulted. Nobody reads it back, not even the AI.

Add connection

Choose a connector.

humi by employment hero
Humi by Employment Hero
360learning
7shifts
Altera Payroll
BambooHR
Dayforce
2

In your AI client

Point it at one endpoint

Everyone in the organization uses the same address, and each person only ever reaches what their own account allows.

Humi by Employment Hero MCP connector for Claude

  1. 1

    Open Customize, then Connectors.

  2. 2

    Press Add.

  3. 3

    Name it, paste the MCP server URL, then Continue.

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

    Sign in and approve.

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

Humi by Employment Hero MCP connector for ChatGPT

  1. 1

    Open Plugins, then press the + button.

  2. 2

    Name it and paste the endpoint into Server URL.

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

    Leave Authentication on OAuth, then tick the risk acknowledgement.

  4. 4

    Press Create, then sign in and approve.

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

Humi by Employment Hero MCP connector for Cursor

  1. 1

    Open ~/.cursor/mcp.json.

  2. 2

    Add the endpoint under mcpServers.

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

    Reload Cursor, then sign in and approve.

~/.cursor/mcp.json

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

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

Connect Humi by Employment Hero to any MCP client

  1. 1

    Add the endpoint as a remote MCP server.

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

    Sign in and approve.

{
  "mcpServers": {
    "elaichi": {
      "url": "https://api.elaichi.ai/mcp"
    }
  }
}

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

Use cases

What teams do with Humi by Employment Hero through Elaichi

Every one of these runs inside the access the person already has, and lands in the same audit log.

  • People

    Answer who is off next week

    Ask which employees have time off requests next week and get the list back in seconds, without opening Humi by Employment Hero and clicking through each person.

  • Managers

    Check a team member's time off history

    Pull up one employee's time off requests before a one on one, so the conversation about balance and coverage starts with the facts.

  • Payroll

    Review additional incomes before the pay run

    List additional incomes such as bonuses and commissions ahead of payroll and ask the agent to summarize what changed since last period.

  • Operations

    Log hours worked after a shift

    Tell the agent who worked and for how long, and it records the time worked in Humi by Employment Hero so nobody types it in twice.

  • Finance

    Pull headcount by department for the forecast

    Ask for a count of current employees broken down by department or location and drop the numbers straight into the budget model.

  • Office

    Find an employee's details fast

    Look up a single employee by name to get their role, manager and start date when a visitor, courier or new hire asks.

Try asking

  • “Who is on time off next week in the Toronto office?”
  • “List pending time off requests for the support team.”
  • “Log eight hours worked today for Priya Shah.”

See all 6 Humi by Employment Hero tools below

AI tools

Humi by Employment Hero tools for your AI agents

6 tools are ready to call through Elaichi's MCP endpoint the moment you connect Humi by Employment Hero, governed by the same roles, restrictions, and audit log as everything else in Elaichi.

See it in Elaichi

What connecting Humi by Employment Hero gets you

6 screens from the product, each doing one job for your Humi by Employment Hero account.

The agent

Ask who is off next week, get answers.

The Elaichi Agent reads live Humi by Employment Hero employees and time off requests.

  • employees
  • time off requests
  • additional incomes
  • time worked

Ask Elaichi to work across your apps.

Who is on time off next week in the Toronto office?

List pending time off requests for the support team.

Log eight hours worked today for Priya Shah.

Also runs in Claude, ChatGPT or Cursor

MCP clients

One endpoint connects Claude, ChatGPT and Cursor.

Use Humi by Employment Hero from any MCP client, with no SDK or shared API key.

ElaichiMCP clients
Claude ChatGPT Cursor

Copy the endpoint

https://api.elaichi.ai/mcp
Client Connected by Status Last used
Claude
E

Emma Laurent

• Connected 4 minutes ago
Cursor
S

Sofia Ricci

• Connected 2 hours ago
ChatGPT
C

Clara Nowak

• Connected Yesterday

Tool catalog

6 tools cover employees, time off and hours.

Every Humi by Employment Hero tool is cataloged and ready, with no code to write.

  • List all Humi by Employment Hero employees
  • Get single Humi by Employment Hero employee by ID
  • List all Humi by Employment Hero time off requests
  • List all Humi by Employment Hero employee time off requests
ElaichiTools
Tool Action Description
List all Humi by Employment Hero employees List List the employees of the Humi company behind the connected token (Humi Partners API, Employee Index). Each record is a JSON:API resource: id, type (employees) and attributes (first/last name, legal names, email, phones, department, position, office, employment_type, start_date, end_date, created_at, updated_at). Deleted employees are not returned. Oldest created_at first; at most 25 per page (use limit and next_cursor). For one employee with manager, salaries or custom fields, use employees.get. Humi labels this API a closed beta; an invalid or revoked token gets a 401 with an empty body.
Get single Humi by Employment Hero employee by ID Get Get one employee by their Humi employee id, a uuid (Humi Partners API, Employee Show). Returns the whole JSON:API document, not only the record: data (id, type, attributes including reports_to_id, the id of the employee this one reports to), jsonapi and meta. Set include to salaries, custom_attributes or both (comma-separated) to also get data.relationships and a top-level included array: salary records (name, rate, frequency, is_primary, effective_at, ends_at) and custom field values (name, value, type, field_group). Deleted employees are not returned.
List all Humi by Employment Hero time off requests List List APPROVED time off requests company-wide that overlap a date range (Humi Partners API, Time Off Index). Required: date_range_start and date_range_end (YYYY-MM-DD), sent as dateRange[start] and dateRange[end]. A request matches when its start_at, end_at or any day between falls in the range. Pending and denied requests are never returned. Records: id, type (timeOffRequest), attributes (employee_id, type, start_at, end_at, status, description, total_amount_days, total_amount_hours, created_at, updated_at). Newest updated_at first; at most 25 per page. Re-send both dates with next_cursor.
List all Humi by Employment Hero employee time off requests List List one employee's APPROVED time off requests that overlap a date range (Humi Partners API, Time Off Show). Required: employee_id (Humi employee uuid), date_range_start and date_range_end (YYYY-MM-DD, sent as dateRange[start] and dateRange[end]). Same matching rule, records (id, type, attributes with employee_id, start_at, end_at, status, day and hour totals, timestamps), order (newest updated_at first) and paging (at most 25 per page) as time_off_requests.list. Re-send all three inputs with next_cursor.
List all Humi by Employment Hero additional incomes List List the company's payroll additional income types (Humi Partners API, Additional Incomes Index). Humi returns the same standard list for every company, but the ids are company-specific: use them as the additional income ids in employee_time_worked.create. Records: id, type (additionalIncome), attributes.name (machine-readable, e.g. holiday_pay) and attributes.displayName. Takes no query parameters; not paginated.

Toolboxes

Each team gets its own toolbox.

People, Payroll and Managers each see only the Humi by Employment Hero tools they need.

  • People
  • Payroll
  • Managers
  • Finance
ElaichiToolboxes
Name Source template Tools Created

People toolbox

Humi by Employment Hero · employees and time off

Humi by Employment Hero starter 18 Mar 4, 2026

Payroll toolbox

Humi by Employment Hero · additional incomes and hours worked

— 9 Mar 2, 2026

Managers toolbox

Humi by Employment Hero · team time off requests

— 24 Feb 27, 2026

Finance toolbox

Humi by Employment Hero · headcount and additional incomes

Humi by Employment Hero starter 6 Feb 19, 2026

Operations toolbox

Humi by Employment Hero · shift hours and coverage

— 31 Jan 30, 2026

IT toolbox

Humi by Employment Hero · employee directory and onboarding

— 12 Jan 22, 2026

Shared connections

Share one connection, never share the key.

Teammates work through a Humi by Employment Hero connection without ever seeing the API key.

  • People Ops
  • Payroll
  • Managers
  • Finance
ElaichiConnections
Connection Scope Status Access
HU

Humi by Employment Hero (People Ops)

Connected by Emma Laurent

Personal • Active 1 team · 6 members
HU

Humi by Employment Hero (Payroll)

Connected by James Whitfield

Organization • Active 3 teams · 24 members
HU

Humi by Employment Hero (Managers)

Connected by Sofia Ricci

Organization • Active 2 teams · 11 members
HU

Humi by Employment Hero (Finance)

Connected by Daniel Ortega

Personal • Needs re-auth 1 team · 3 members
HU

Humi by Employment Hero (Operations)

Connected by Clara Nowak

Personal • Active Not shared
HU

Humi by Employment Hero (Canada HQ)

Connected by Michael Brennan

Personal • Active 2 teams · 9 members

Audit log

Every call names who did what.

Each lookup and logged shift in Humi by Employment Hero lands in an append-only audit log.

  • When
  • Who
  • What happened
  • Type
ElaichiAudit log
When Who What happened Type

2 minutes ago

Mar 6, 2026, 3:10 PM

E

Emma Laurent

[email protected]

Restriction Created Access

8 minutes ago

Mar 6, 2026, 3:04 PM

J

James Whitfield

[email protected]

Restriction Updated Access

14 minutes ago

Mar 6, 2026, 2:58 PM

S

Sofia Ricci

[email protected]

Role Assigned Access

20 minutes ago

Mar 6, 2026, 2:52 PM

D

Daniel Ortega

[email protected]

Humi by Employment Hero Users Updated MCP

26 minutes ago

Mar 6, 2026, 2:46 PM

C

Clara Nowak

[email protected]

Humi by Employment Hero Employees Created MCP

32 minutes ago

Mar 6, 2026, 2:40 PM

M

Michael Brennan

[email protected]

Humi by Employment Hero Employees List Toolbox

Launching soon

From answering questions to doing the work

A person no longer has to ask. A trigger starts the work, inside the same permissions and the same audit log as everything else. Automations and live dashboards are launching soon, on the Black plan.

Automations

A schedule fires and the work gets done.

Time off requests are fetched, grouped, drafted into a digest, approved, then posted back.

Humi by Employment Hero digest

Run 418 · started 2 minutes ago · on behalf of Emma Laurent

  1. ✓

    Schedule

    Every weekday at 08:00

    0.2s
  2. ✓

    Fetch employees

    Humi by Employment Hero

    1.4s
  3. ✓

    Group by owner

    Transform

    0.1s
  4. ✓

    Draft the digest

    Agent step

    Ran with 4 tools, returned a structured summary

    6.2s
  5. Approve the digest

    Needs approval

    Assigned to Michael Brennan

    Approve
  6. Post the digest

    Humi by Employment Hero

    Queued

Collections and dashboards

Headcount and time off numbers, refreshed on schedule.

Four metrics, a 14 day chart and a team breakdown, computed with no model involved.

Humi by Employment Hero health

Refreshed 4 minutes ago · every 15 minutes · from the employees collection

Live

Employees

1,284 ↓ 12%

Time off requests

96 ↓ 8%

Needs attention

3 ↑ 2

Updated this week

412 ↑ 9%

Employees created

Last 14 days

By team

Share of activity

People Ops 34%

Payroll 27%

Managers 21%

Finance 18%

FAQ

Frequently asked questions

How do I connect Humi by Employment Hero to Claude?

Connect Humi by Employment Hero in Elaichi first: pick it from the catalog and paste in the API key from your Humi account, which takes about a minute. There is no OAuth application to register and no client ID or secret to generate. Then open Claude, go to Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Claude asks you to sign in to Elaichi, and from then on it can work with Humi by Employment Hero as you.

Does Humi by Employment Hero work with ChatGPT and Cursor as well as Claude?

Yes. Once Humi by Employment Hero is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client and the Elaichi Agent. You connect Humi by Employment Hero once and every client picks it up.

What can an AI agent actually do with my Humi by Employment Hero data?

An agent connected to Humi by Employment Hero can list employees, look up one employee's details, show time off requests for the whole company or a single person, list additional incomes such as bonuses, and log hours worked for an employee. In practice that means asking who is off next week, checking a team member's leave history, or recording a shift after it ends. Short, concrete asks such as "list pending time off for the support team" work better than long sentences.

Does connecting Humi by Employment Hero give the AI access to every employee record?

No. Every call to Humi by Employment Hero runs under the access of the person who signed in, so a manager sees what that manager can already see in Humi, and an administrator sees what an administrator sees. Elaichi can narrow that access further with restrictions, but it can never widen it beyond what Humi by Employment Hero already allows that person.

Can my team share one Humi by Employment Hero connection?

Yes. One person connects Humi by Employment Hero with the API key and shares the connection with a team in Elaichi, and nobody else ever sees or handles the key. Each teammate still signs in to Elaichi as themselves, so the audit log names the actual person behind every lookup and every logged shift.

Can I stop an agent from logging hours or changing anything in Humi by Employment Hero?

Yes. Restrictions in Elaichi apply per action, so you can allow reading employees and time off requests while blocking the one action that writes to Humi by Employment Hero, logging time worked. A restricted action is never advertised to Claude, ChatGPT or any other client, so no prompt, however worded, can reach it.

What happens to a Humi by Employment Hero connection when someone leaves?

Offboarding a person in Elaichi ends their access to Humi by Employment Hero through every client at once. If the connection was shared with a team, it keeps working for everyone else, because nobody's access depended on that person's login. If you want Humi by Employment Hero gone entirely, disconnecting it once in Elaichi removes it from Claude, ChatGPT, Cursor and every other client together.

Does the Humi by Employment Hero MCP connector work with Gemini, Codex, Claude Code or other MCP clients?

Yes. Humi by Employment Hero 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, and the Elaichi Agent. The tools on offer and the access behind them are identical whichever client asks. Only the setup screen differs.

Put Humi by Employment Hero in front of your team

14 days on Gold, no credit card. Connect it once and pick what each team can call.

Works with
Claude ChatGPT Cursor and any other MCP client, or the Elaichi Agent.
When the trial ends
Nothing is deleted. Connections, roles and the audit log stay where they are, so subscribing picks up exactly where you left off.