Employment Hero Payroll MCP by usefulapi

Employment Hero Payroll MCP by usefulapi

Use Employment Hero Payroll (formerly KeyPay) from Claude, Cursor, or any MCP client — read your businesses, employees, pay runs, payslips and pay run totals, timesheets, leave requests and balances, pay schedules, locations, pay categories and work types, run gross-to-net and leave-balance reports, and approve or decline leave requests. Known tax, identity and bank-account fields are removed from replies, and labelled identifiers in free text are masked on a best-effort basis; unlabelled identifiers may remain, and names, pay and other personal details are visible to your AI assistant. Hosted, no local install: connect with your Employment Hero Payroll API key and pick your region (AU, NZ, SG, MY or UK).

Live endpoint: https://keypay.usefulapi.io/mcp · Homepage: https://usefulapi.io/keypay

Connect

• Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://keypay.usefulapi.io/mcp.
• Claude Code: claude mcp add --transport http keypay https://keypay.usefulapi.io/mcp, then run /mcp to log in.
• VS Code: Add to VS Code.
• Cursor and other clients: add the URL as a remote MCP server:

{
  "mcpServers": {
    "keypay": {
      "url": "https://keypay.usefulapi.io/mcp"
    }
  }
}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Employment Hero Payroll credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/keypay/

Tools

Tool	Type	What it does
keypay_get_user	read	Get current user
keypay_list_businesses	read	List businesses
keypay_get_business	read	Get business
keypay_list_employees	read	List employees
keypay_get_employee	read	Get employee
keypay_get_leave_balances	read	Get employee leave balances
keypay_list_pay_runs	read	List pay runs
keypay_get_pay_run	read	Get pay run
keypay_list_pay_run_summaries	read	List pay run summaries
keypay_get_pay_run_summary	read	Get pay run summary
keypay_get_pay_run_totals	read	Get pay run totals per employee
keypay_get_pay_run_payslips	read	Get pay slip data of a pay run
keypay_list_pay_run_warnings	read	List pay run warnings
keypay_list_timesheets	read	List timesheets
keypay_get_timesheet	read	Get timesheet line
keypay_list_leave_requests	read	List leave requests
keypay_get_leave_request	read	Get leave request
keypay_list_leave_categories	read	List leave categories
keypay_list_pay_schedules	read	List pay schedules
keypay_list_locations	read	List locations
keypay_list_pay_categories	read	List pay categories
keypay_list_work_types	read	List work types
keypay_report_gross_to_net	read	Gross to net report
keypay_report_leave_balances	read	Leave balances report
keypay_approve_leave_request	write	Approve leave request
keypay_decline_leave_request	write	Decline leave request
keypay_usage_status	meta	Usage status (free-tier meter)
keypay_request_feature	meta	Request a missing feature
keypay_upgrade	meta	Upgrade to Pro (unlimited*)
keypay_cancel_subscription	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

Plan	Price	Limit
Free	$0	50 tool calls / month
Pro (per user)	$9/mo or $90/yr (2 months free)	Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with keypay_upgrade (it returns a Stripe Checkout link). Cancel any time with keypay_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running keypay_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Employment Hero.