# kiwiHR Muse connector

From musedirectory.ai, the independent directory of Meta Muse connectors. Not affiliated with Meta.

## kiwiHR

Manage employees, timesheets, time off and onboarding in kiwiHR

- Record: https://musedirectory.ai/connector/kiwihr
- Category: Productivity
- Developer: usefulapi (https://usefulapi.io/kiwihr/)
- Muse status: Extra setup. Not in Muse's Connectors list yet. Muse can still use it: its page gives you a request to paste into Muse.
- Health: Working, 186ms, checked 2026-10-29T22:56:15Z
- Endpoint: https://kiwihr.usefulapi.io/mcp
- Auth: No account needed; Pricing: unknown
- Screening: Screened, no issues found (2026-10-29T22:56:15Z)
- Source: Found in the official MCP Registry (io.usefulapi/kiwihr) https://registry.modelcontextprotocol.io/v0/servers?search=io.usefulapi%2Fkiwihr

Connect to kiwiHR to read and manage employee records, timesheets, time off balances, projects and onboarding journeys. Create and update employees, log time entries and manage projects.

Example request: "Show me who was out on vacation last month and their current time off balance"

How to connect: Not in Muse's Connectors list yet, but Muse can still use it. Paste this into Muse: "Use kiwiHR to help me. It is a free service with an MCP server at https://kiwihr.usefulapi.io/mcp. It does not need an API key. Ask me before you share anything with it." Muse asks before it shares anything with the app's site. Meta does not review apps used this way, so only use ones you trust. We tested this in the Muse app on September 24, 2026: Muse used an app's link directly this way and returned a live answer.

Tools:
- kiwihr_list_users: 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. Graph
- kiwihr_get_user: 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 addre
- kiwihr_list_teams: List teams and departments (id, name, kind GROUP or DEPARTMENT). Use the ids to filter employees. GraphQL query teams.
- kiwihr_list_locations: List office locations (id, name). Use the ids to filter employees. GraphQL query locations.
- kiwihr_list_positions: List job positions (id, name). Use the ids to filter employees. GraphQL query positions.
- kiwihr_list_custom_fields: 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_time_off_types: 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_time_off_balances: 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 f
- kiwihr_get_time_off_usage: 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 time
- kiwihr_list_timesheets: 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 quer
- kiwihr_get_timesheet: 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_attendance_statement: 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_list_attendance_statements: 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 q
- kiwihr_list_overtime_balances: Current overtime balance (seconds) per employee. GraphQL query overtimeBalanceStatements.
- kiwihr_list_projects: List time-tracking projects (id, name, status ACTIVE or INACTIVE). GraphQL query projects.
- kiwihr_get_project: One time-tracking project by id (name, status). GraphQL query project.
- kiwihr_list_journeys: 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_get_journey: 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_list_journey_templates: List journey templates (id, name, description, type). Use a template id with kiwihr_create_journey. GraphQL query journeyTemplates.
- kiwihr_list_journey_types: List journey types such as pre-onboarding, onboarding or offboarding (id, name, key, archived date). GraphQL query journeyTypes.
- kiwihr_create_timesheet_entry: 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 (n
- kiwihr_update_timesheet_entry: 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_delete_timesheet_entry: 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_create_project: 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_update_project: 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_create_user: 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. G
- kiwihr_update_user: 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
- kiwihr_deactivate_user: 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_activate_user: WRITE: re-activate a deactivated employee so they appear in active lists and can use kiwiHR again. GraphQL mutation activateUser.
- kiwihr_create_journey: 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 re

Screening checks:
- MCP handshake: pass (Answered in 186ms)
- Domain against threat feeds (Cloudflare security DNS): pass (kiwihr.usefulapi.io, usefulapi.io not flagged)
- Published packages against the OSV malicious-package database: n/a (No npm or PyPI package published)
- Hidden instructions or invisible characters in tool text: pass (30 tools read, nothing found)
- Inputs asking for passwords, card numbers or seed phrases: pass (None found)
- Domain and redirects: pass (No redirects off the domain)
- AI review of purpose and tool behavior: pass (No concerns)