usefulapikiwiHR MCP server
Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.
What can I ask?
Turn on the kiwiHR connector, then ask in plain words. The AI picks the tools.
- Who is off next week, and what time off do they have left?
- List the active employees in the Sales team with their managers.
- Show Anna Novak's timesheets for last week and add a missing 09:00-17:00 entry for Monday.
- Start an onboarding journey for our new hire from the standard template.
What you can do with kiwiHR in Claude and ChatGPT
For HR managers and people teams who run time off, timesheets and onboarding in kiwiHR.
See who is off and what time off is left
The AI reads who took or requested time off in a date range, and the time off balances per employee: allowance, used, planned and available days.
List the employees of a team with managers
The AI lists employees filtered by team, location, position or active state, with position, manager and employment dates.
Compare expected and tracked time
The AI reads attendance statements for all employees or one: expected and tracked time, time off, holidays, overtime and time per project.
Review a timesheet and add or update an entry
The AI reads the daily timesheets of an employee in a date range, then adds a time entry or changes an existing one.
Changes dataAdd a new employee and an onboarding journey
The AI creates an employee record, then creates an onboarding journey from a journey type and template. The journey is not published.
Changes dataDeactivate or reactivate an employee
The AI deactivates an employee who left, so they lose access to kiwiHR, or reactivates them. Both steps can be reversed.
Changes dataHow do I connect kiwiHR?
Before you connect
The login page asks for your kiwiHR API key.
Create it in the Tellent HR (kiwiHR) web app under Company Settings (API key). The key acts as the first Administrator of your company, so it can read and change everything an admin can: share it only if you are happy for your AI assistant to have that access. It is used only to call the kiwiHR API on your behalf and is never shown to anyone.
Claude claude.ai · Desktop
- Open Customize → Connectors, then click + Add → Add custom connector.
- Enter the name kiwiHR and this URL, then click Add:https://
kiwihr. usefulapi. io/ mcp - Claude opens the login page: enter your kiwiHR API key.
- In a chat, click + → Connectors and turn on kiwiHR.
Team and Enterprise: an Owner adds the connector for the organization first.
ChatGPT chatgpt.com
- Open Plugins, click +, then Add custom MCP server.
- Enter the name kiwiHR and this URL, choose OAuth as the authentication, confirm the warning and create it:https://
kiwihr. usefulapi. io/ mcp - ChatGPT opens the login page: enter your kiwiHR API key.
- In Plugins, install kiwiHR, then choose it in a chat.
No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.
Claude Code
Run this command, then run /mcp in Claude Code to log in:
Cursor
Add to Cursor or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"kiwihr": {
"url": "https://kiwihr.usefulapi.io/mcp"
}
}
} VS Code
Add to VS Code or add this to .vscode/mcp.json:
{
"servers": {
"kiwihr": {
"type": "http",
"url": "https://kiwihr.usefulapi.io/mcp"
}
}
} Codex
Run these commands. The second one opens the login page:
Other clients
Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.
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: the login page asks for your kiwiHR API key. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Proper user | $9/mo · $90/yr | 10,000 tool calls / month |
| Pro+per user | $39/mo · $390/yr | 100,000 tool calls / month |
Each paid plan covers this kiwiHR server only. Ask your AI to run kiwihr_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with kiwihr_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with kiwihr_upgrade before then undoes the cancel. Or write to support@usefulapi.io.
Tools 34
Show all 34 tools (the AI picks them for you)
Read only · 20
- List employees
kiwihr_list_usersList or search employees (kiwiHR 'users') with name, work email, active flag, employee number, employment dates, position, team, location and manager. Filter by active state, team, location, position, e-mail or name. Payroll, bank, tax and insurance data are never included. GraphQL query users. - Get employee
kiwihr_get_userOne employee by id: the list fields plus probation end, about-me, language, invitation status, work phones, all teams, work schedule and custom field values. With include_personal=true it also returns birth date, private e-mail and phone, nationality, gender, pronouns, home address, emergency contact and custom fields of the personal sections. Payroll, bank (IBAN/BIC), tax and insurance data are never returned. GraphQL query user. - List teams
kiwihr_list_teamsList teams and departments (id, name, kind GROUP or DEPARTMENT). Use the ids to filter employees. GraphQL query teams. - List locations
kiwihr_list_locationsList office locations (id, name). Use the ids to filter employees. GraphQL query locations. - List positions
kiwihr_list_positionsList job positions (id, name). Use the ids to filter employees. GraphQL query positions. - List custom fields
kiwihr_list_custom_fieldsList the company's custom employee profile fields (id, name, section, data type, choice options). Payroll and bank sections are listed by name only; their values are never returned by any tool. GraphQL query customFields. - List time off types
kiwihr_list_time_off_typesList time off (absence) types such as vacation or sick leave: id, name, colour, visibility to team members. Use the ids with kiwihr_get_time_off_usage and kiwihr_list_time_off_balances. GraphQL query timeOffTypes. - List time off balances
kiwihr_list_time_off_balancesTime off balances of all employees: per employee and time off rule the allowance, accrued, used, requested, planned and available days, carry-over and the accrual/usage periods. Filter by time off type, active state and usage period. The API has no per-employee filter or paging for this query; read the result per user. GraphQL query timeOffBalances. - Get time off usage
kiwihr_get_time_off_usageWho took (or requested) how much time off in a date range: per employee the request count and used days for each time off rule of the chosen time off types. Use it for absence reports ('who was off in March?'). Optional employee filters as in kiwihr_list_users. GraphQL query timeOffRequestUsageStatements. - List timesheets
kiwihr_list_timesheetsDaily timesheets of one employee (or the key's admin user when user_id is omitted) in a date range: expected, tracked, time off, holiday and break time in SECONDS, approval flag, time offs, holidays, entries (start/end, type, note, project) and break-rule violations. GraphQL query timesheets. - Get timesheet
kiwihr_get_timesheetThe timesheet of ONE employee for ONE day (user_id omitted = the admin user the key acts as), with all entries and their ids (needed to update or delete an entry). Times in seconds. GraphQL query timesheet. - Get attendance statement
kiwihr_get_attendance_statementAttendance summary of ONE employee over a date range: expected, tracked, total, time off and holiday time (seconds) and days, balance, overtime, meal vouchers, and tracked time per project. GraphQL query attendanceStatement. - List attendance statements
kiwihr_list_attendance_statementsAttendance summaries of ALL employees over a date range (expected vs tracked time, time off, holidays, balance, overtime, tracked time per project). Optionally only employees with time tracked on a project, or with uncategorized time; inactive employees can be included. GraphQL query attendanceStatements. - List overtime balances
kiwihr_list_overtime_balancesCurrent overtime balance (seconds) per employee. GraphQL query overtimeBalanceStatements. - List projects
kiwihr_list_projectsList time-tracking projects (id, name, status ACTIVE or INACTIVE). GraphQL query projects. - Get project
kiwihr_get_projectOne time-tracking project by id (name, status). GraphQL query project. - List journeys
kiwihr_list_journeysList onboarding/offboarding journeys (id, name, status DRAFT/ONGOING/COMPLETED/CANCELLED, assignee, journey type, custom date). Filter by status, assignee, type or team. GraphQL query journeys. - Get journey
kiwihr_get_journeyOne journey by id with its steps (name, description, fixed start and due dates). With include_personal=true it also returns the private e-mail address stored on the journey. GraphQL query journey. - List journey templates
kiwihr_list_journey_templatesList journey templates (id, name, description, type). Use a template id with kiwihr_create_journey. GraphQL query journeyTemplates. - List journey types
kiwihr_list_journey_typesList journey types such as pre-onboarding, onboarding or offboarding (id, name, key, archived date). GraphQL query journeyTypes.
Changes data · 10
- Create timesheet entry
kiwihr_create_timesheet_entryWRITE: add a time entry to the timesheet of one employee on one day (user_id omitted = the admin user the key acts as). type MANUAL = worked time (give start_at and end_at as HH:mm:ss, or a part_of_day), BREAK = a break. Optional project and note. Creates a new entry each call (not idempotent). Returns the updated day. GraphQL mutation createTimesheetEntry. - Update timesheet entry
kiwihr_update_timesheet_entryWRITE: change an existing timesheet entry (get its id from kiwihr_get_timesheet): times, part of day, project or note. Only the fields you pass are changed. Setting the same values again gives the same result. Returns the updated day. GraphQL mutation updateTimesheetEntry. - Delete timesheet entry
kiwihr_delete_timesheet_entryWRITE, DESTRUCTIVE: permanently delete one timesheet entry by id (get it from kiwihr_get_timesheet). This cannot be undone. Returns true when deleted. GraphQL mutation deleteTimesheetEntry. - Create project
kiwihr_create_projectWRITE: create a time-tracking project (name, status ACTIVE or INACTIVE; default ACTIVE). Creates a new project each call (not idempotent). GraphQL mutation createProject. - Update project
kiwihr_update_projectWRITE: rename a project or switch it ACTIVE/INACTIVE (INACTIVE projects can no longer be used for time tracking). Only the fields you pass are changed. GraphQL mutation updateProject. - Create employee
kiwihr_create_userWRITE: add a new employee record (first name, last name and work e-mail are required; optional start date, manager, teams, position, location and phones). Creates a new employee each call (not idempotent). No invitation is sent by this tool. Payroll and bank data cannot be set. GraphQL mutation createUser. - Update employee
kiwihr_update_userWRITE: change an employee's work profile: name, start date, about-me, work phones, position, team(s), location, manager. Only the fields you pass are changed (team_ids replaces the whole team list). Private, payroll and bank data cannot be changed with this tool. GraphQL mutation updateUser. - Deactivate employee
kiwihr_deactivate_userWRITE, ACCESS-CHANGING: deactivate an active employee (typically after they leave): they lose access to kiwiHR and drop out of active lists. Reversible with kiwihr_activate_user. GraphQL mutation deactivateUser. - Activate employee
kiwihr_activate_userWRITE: re-activate a deactivated employee so they appear in active lists and can use kiwiHR again. GraphQL mutation activateUser. - Create journey
kiwihr_create_journeyWRITE: create an onboarding/offboarding journey for an employee from a journey type and optionally a template (ids from kiwihr_list_journey_types / kiwihr_list_journey_templates). Creates a new journey each call (not idempotent). It does not publish it; check the status in the reply. GraphQL mutation createJourney.
Your usefulapi plan · 4
- Usage status (free-tier meter)
kiwihr_usage_statusReport the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter. - Request a missing feature
kiwihr_request_featureTell usefulapi that the user needs something the kiwiHR tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter. - Upgrade to Pro or Pro+
kiwihr_upgradeGet a paid plan for kiwiHR (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place: call without confirm first, as the reply states the exact charge for this account (the price difference for the rest of the period, or in a free Pro trial the full Pro+ price, as the trial ends); then call with confirm: true. Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter. - Cancel the Pro subscription
kiwihr_cancel_subscriptionCancel the caller's kiwiHR Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run kiwihr_upgrade later to undo the cancel before the period ends. Does not count against the meter.
FAQ
What can I do with kiwiHR in Claude or ChatGPT?
See who is off and what time off is left. List the employees of a team with managers. Compare expected and tracked time. Review a timesheet and add or update an entry. Add a new employee and an onboarding journey. Deactivate or reactivate an employee. See what you can do for the details.
Is this an official kiwiHR product?
No. usefulapi is an independent service. It is not affiliated with or endorsed by kiwiHR. The server calls the kiwiHR API with your own kiwiHR access, so it sees only the data that your account can see.
Can I connect kiwiHR to Claude or ChatGPT?
Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.
What do I need to connect?
The login page asks for your kiwiHR API key. See Before you connect for where to find it.
Do I put my kiwiHR key or an Authorization header in the client config?
No. 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: the login page asks for your kiwiHR API key. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.
How do you keep my kiwiHR credentials?
The login stores them encrypted in the authorization grant of your connection. The server uses them to call the kiwiHR API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. To stop all access, remove the connector and change or delete these credentials in kiwiHR.
Can the AI change my kiwiHR data?
Yes, if you approve it. 10 of the 30 kiwiHR tools can create or change data. The other 20 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.
What does it cost?
The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this kiwiHR server only. Cancel any time: your paid plan then runs to the end of the paid period. Run kiwihr_usage_status to see how many calls you used.
How do I subscribe or cancel?
Ask the AI to run kiwihr_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run kiwihr_cancel_subscription. Your paid plan continues to the end of the paid period.
What if a kiwiHR tool that I need is missing?
Tell the AI what you wanted to do. It can send the request with kiwihr_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.
Which AI clients can I use?
Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.
This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.
Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.