Skip to Content

Connect Kaonavi to Your AI Agent

Use AI to query employee records and understand your personnel data structure.

23 toolsCustom credential

20,000 free app calls every month(paid services billed separately)

Try a Kaonavi Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillKaonavi

Review personnel changes

Find recently updated employee records and their personnel sheets.

/oo Kaonavi: List employees updated since 2026-10-01 and show the available personnel sheet layouts.

Start Working with Kaonavi

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Kaonavi

    Connect administrator-issued Consumer Key and Consumer Secret credentials.

    Connect Kaonavi→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • Obtain credentials under Administrator Functions > Public API v2 Information > Authentication Information.
  • Enable the required resource operations in Kaonavi; all operations are disabled by default.
  • Your organization must have access to the public API.
  • Temporary access tokens are obtained automatically.
  • Connection verification checks token issuance; access to each resource depends on permissions.
  • Writes support validation-only dryRun where offered by Kaonavi. Asynchronous writes return a task ID; check get_task for completion.
  • Updating multiple-record sheets replaces the complete record set for each supplied employee; use append_sheet_records to add records.
  • Photo and attachment download links expire after 15 minutes.

Kaonavi Tools

Connect Kaonavi with a Consumer Key and Consumer Secret. Query personnel data, create and update employees, maintain sheet records and login users, retrieve photo and attachment links, and track asynchronous write tasks.

Personnel data and layouts

Read employee records, personnel sheets, field definitions, and departments.

Users, roles, master options, and tasks

Inspect users, roles, master options, and asynchronous task results.

Personnel and account maintenance

Create and update employees, update or append personnel records, and manage login users.

Photo and attachment links

Get temporary download links for employee photos and sheet attachments.

23 tools

List Members

List employee records, optionally filtered by update date.

kaonavi.list_members

Get Member Layout

Get employee field definitions and required-field settings.

kaonavi.get_member_layout

List Sheet Layouts

List accessible personnel sheet layouts and custom field definitions.

kaonavi.list_sheet_layouts

Get Sheet Layout

Get the field layout of a personnel sheet.

kaonavi.get_sheet_layout

Get Sheet

Get personnel sheet records, optionally filtered by member update date.

kaonavi.get_sheet

List Departments

List organizational departments and their parent relationships.

kaonavi.list_departments

List Users

List Kaonavi login users and account settings.

kaonavi.list_users

Get User

Get a Kaonavi login user by ID.

kaonavi.get_user

List Roles

List available Kaonavi user roles.

kaonavi.list_roles

List Enum Options

List master options for custom fields.

kaonavi.list_enum_options

Get Enum Options

Get master options for one custom field.

kaonavi.get_enum_options

Get Task

Get the status and messages of an asynchronous Kaonavi task.

kaonavi.get_task

Create Members

Create employees with their basic fields and department assignments. Consult get_member_layout for required fields.

kaonavi.create_members

Update Members

Update only the supplied employee fields. Omitted fields remain unchanged; use an empty string to clear a value.

kaonavi.update_members

Update Sheet

Update a personnel sheet. Single-record sheets preserve omitted fields; multiple-record sheets replace the entire record set for each supplied employee. Other employees remain unchanged.

kaonavi.update_sheet

Append Sheet Records

Append records to a multiple-record personnel sheet. Single-record sheets are not supported.

kaonavi.append_sheet_records

Create User

Create a Kaonavi login user linked to an employee.

kaonavi.create_user

Update User

Update a login user, including role, password, access settings, or disabling the account. Omitted fields remain unchanged.

kaonavi.update_user

Delete User

Delete a Kaonavi login user.

kaonavi.delete_user

Create Users

Create multiple Kaonavi login users asynchronously.

kaonavi.create_users

Update Users

Update multiple login users asynchronously, including disabling accounts. Omitted fields remain unchanged.

kaonavi.update_users

List Member Photo Urls

Get employee photo download URLs. Links expire after 15 minutes; request new URLs when needed.

kaonavi.list_member_photo_urls

List Sheet File Urls

Get download URLs for files in a sheet attachment field. Only records containing files are returned. Links expire after 15 minutes.

kaonavi.list_sheet_file_urls

Frequently Asked Questions

Do I need to paste a new token every hour?

No. Connector obtains and renews temporary access tokens from your Consumer Key and Consumer Secret.