MCP server

kiwiHR MCP by usefulapi

io.usefulapi/kiwihr

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

30

Token cost

About 7,821 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http kiwihr https://kiwihr.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.kiwihr]
url = "https://kiwihr.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"kiwihr":{"httpUrl":"https://kiwihr.usefulapi.io/mcp"}}}

Cursor

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

VS Code

{"servers":{"kiwihr":{"type":"http","url":"https://kiwihr.usefulapi.io/mcp"}}}

Antigravity

agy mcp add kiwihr https://kiwihr.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"kiwihr","server_url":"https://kiwihr.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"kiwihr","server_url":"https://kiwihr.usefulapi.io/mcp"}

Tools

• kiwihr_activate_user ~112 tokens
  WRITE: re-activate a deactivated employee so they appear in active lists and can use kiwiHR again. GraphQL mutation activateUser.
• kiwihr_create_journey ~424 tokens
  WRITE: 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 mutatio
• kiwihr_create_project ~157 tokens
  WRITE: create a time-tracking project (name, status ACTIVE or INACTIVE; default ACTIVE). Creates a new project each call (not idempotent). GraphQL mutation createProject.
• kiwihr_create_timesheet_entry ~410 tokens
  WRITE: 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). Retu
• kiwihr_create_user Changes accounts · ~463 tokens
  WRITE: 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 crea
• kiwihr_deactivate_user Changes accounts · ~136 tokens
  WRITE, 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.
• kiwihr_delete_timesheet_entry Deletes data · ~134 tokens
  WRITE, 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.
• kiwihr_get_attendance_statement ~209 tokens
  Attendance 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.
• kiwihr_get_journey ~165 tokens
  One 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.
• kiwihr_get_project ~96 tokens
  One time-tracking project by id (name, status). GraphQL query project.
• kiwihr_get_time_off_usage ~471 tokens
  Who 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 timeOffRequestUsageState
• kiwihr_get_timesheet ~173 tokens
  The 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.
• kiwihr_get_user ~243 tokens
  One 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 contac
• kiwihr_list_attendance_statements ~357 tokens
  Attendance 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 attendanceState
• kiwihr_list_custom_fields ~236 tokens
  List 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.
• kiwihr_list_journey_templates ~197 tokens
  List journey templates (id, name, description, type). Use a template id with kiwihr_create_journey. GraphQL query journeyTemplates.
• kiwihr_list_journey_types ~161 tokens
  List journey types such as pre-onboarding, onboarding or offboarding (id, name, key, archived date). GraphQL query journeyTypes.
• kiwihr_list_journeys ~368 tokens
  List 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.
• kiwihr_list_locations ~193 tokens
  List office locations (id, name). Use the ids to filter employees. GraphQL query locations.
• kiwihr_list_overtime_balances ~203 tokens
  Current overtime balance (seconds) per employee. GraphQL query overtimeBalanceStatements.
• kiwihr_list_positions ~192 tokens
  List job positions (id, name). Use the ids to filter employees. GraphQL query positions.
• kiwihr_list_projects ~222 tokens
  List time-tracking projects (id, name, status ACTIVE or INACTIVE). GraphQL query projects.
• kiwihr_list_teams ~200 tokens
  List teams and departments (id, name, kind GROUP or DEPARTMENT). Use the ids to filter employees. GraphQL query teams.
• kiwihr_list_time_off_balances ~336 tokens
  Time 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
• kiwihr_list_time_off_types ~229 tokens
  List 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.
• kiwihr_list_timesheets ~315 tokens
  Daily 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.
• kiwihr_list_users ~578 tokens
  List 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.
• kiwihr_update_project ~176 tokens
  WRITE: 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.
• kiwihr_update_timesheet_entry ~302 tokens
  WRITE: 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.
• kiwihr_update_user ~363 tokens
  WRITE: 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.

Browse

• Email

Related MCP servers

• Timix.AI
  Time tracking, live project budgets, and billing exports for service firms.
• FieldPulse MCP by usefulapi
  Read FieldPulse customers, jobs, estimates, invoices, assets and projects; create and update jobs.
• Deputy MCP by usefulapi
  See rosters, timesheets, leave and staff in Deputy, and create shifts, leave and memos.
• Shiftbase MCP by usefulapi
  Read Shiftbase rosters, timesheets, absences and availability; schedule shifts and review absences.
• Employment Hero Payroll MCP by usefulapi
  Read Employment Hero Payroll pay runs, payslips, timesheets and leave; approve or decline leave.
• bexio MCP by usefulapi
  Read bexio contacts, invoices, quotes, bills, projects and journal; log time, draft invoices.
• Connecteam MCP by usefulapi
  Read Connecteam users, shifts, time clock, jobs, time off, tasks and forms; create shifts and tasks.
• Paymo MCP by usefulapi
  Browse Paymo projects, tasks, timesheets and invoices, and create tasks, log time or run timers.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/kiwihr.svg)](https://aptlynx.net/servers/io.usefulapi/kiwihr)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents