You forget to clock in and notice after lunch. At the end of the month you want to check your overtime, so you open the attendance screen all over again. At companies that use HRMOS Kintai (HRMOS Attendance), small tasks like these come up almost every day.
This article is for the admins and employees of companies using HRMOS Kintai, and explains how to clock in from chat and check your own workdays and remaining leave. In the second half, we also show how admins and managers can check company-wide attendance and monthly reports in chat.
Summary
- HRMOS Kintai has an official REST API. You issue an API KEY on the admin screen, then use its Secret Key to issue a token
- HRMOS Kintai itself also has "Slack clock-in," which lets you clock in from Slack. If you only need to clock in and see your own attendance summary, start with that
- Samurai App's HRMOS Kintai integration uses this API. You can handle clocking in, fixing missed punches, a month's workdays and totals, and remaining leave in chat, for your own records only
- Admins and managers can also see the attendance of the whole company or of specific employees, everyone's attendance on a given day, and monthly reports in chat. They can only view; they cannot clock in or make corrections for other people
- Month-end close requests and approvals, year-end tax adjustment documents, and clock-in location information cannot be handled from chat
Three ways to clock in from chat
| HRMOS Kintai's Slack clock-in | Integration tools that call the API | Samurai App chat | |
|---|---|---|---|
| Provided by | HRMOS Kintai | The tool's provider | Samurai App |
| Clocking in | Clock in, clock out, start and end of breaks | Depends on the tool's settings | Clock in, clock out, start and end of breaks |
| Viewing your own attendance | A summary as of today | Depends on the tool's settings | A month's records by workday and totals, punch history, remaining leave |
| Viewing company-wide attendance | No | Depends on the tool's settings | Admins and managers only |
| How you ask | Fixed short commands | A flow you set up in advance | Everyday language |
HRMOS Kintai's Slack clock-in is a feature where you install the HRMOS Kintai app in Slack and clock in by mentioning the app with in (clock in) or out (clock out). According to HRMOS Kintai's guide, sending s shows a summary of total working hours, actual working hours, overtime, and remaining paid leave to you alone. An admin enables Slack clock-in under "System Administration" → "System Settings," and each person links their Slack account under "Account Settings" → "Account Linking."
Integration tools that call the API are a way to call the HRMOS Kintai API from a no-code automation service or similar. They suit running a fixed flow automatically, such as "clock in when I post to this channel."
Samurai App chat differs in that you can ask without memorizing fixed commands. You can keep clocking in, checking, and correcting in the same conversation, as in "I clocked in at 9:30 last Wednesday, so fix my clock-in time."
What Samurai App can and cannot do
The HRMOS Kintai settings on the Connectors screen (/settings/connections) list "What you can do from chat," split into three groups. You can read it even before connecting.
View your own attendance (anyone)
- See your own attendance for a month, with totals for actual working, overtime, and late-night hours. For each day you can see the work category, clock-in, clock-out, and break times (both entered and punched times), and actual working, overtime, late-night, and within-statutory hours. Months are divided according to each person's closing date set in HRMOS Kintai
- See your own punch history, newest first. You can also narrow it to clock-ins only, clock-outs only, and so on
- See your own leave granted, taken, and remaining, by fiscal year
- See the lists of work categories, departments, employment types, locations, and leave types
Clock in and make corrections (your own records only; by default, a confirmation appears before it runs)
- Clock in, clock out, and start and end breaks. The punch time is always the time you ask. A night-shift punch can also be counted toward the previous day's work
- Correct the clock-in, clock-out, and break times for your own day. You can fix up to two breaks. Only days that already exist in HRMOS Kintai can be corrected
View company-wide attendance (admins and managers only)
- See the employee list, with employee number, name, email address, hire date, department, employment type, and location
- See a month's attendance for the whole company or a specific employee
- See the whole company's attendance on a given day
- See monthly reports, with scheduled and actual working hours, overtime brackets of 45 and 60 hours, days worked, days absent, days late, and paid leave taken and remaining. You can also filter by request or approval status
- See other employees' remaining leave
Admins and managers here are roles in Samurai App. What they can read is the whole company; there is no setting to narrow it to a department or team.
What it cannot do
- Clock in or make corrections for other employees
- Clock in with a past time. Fix a missed punch by correcting that day's time
- Month-end close requests and approvals
- Year-end tax adjustment documents
- Clock-in location information (position or address)
Examples
Employees checking their own attendance
- Clocking in in the morning. Ask "Clock me in," an approval card appears, and when you allow it, the punch time comes back
- Fixing a missed punch. Ask "I forgot to clock out yesterday. Fix it to 18:40." Before the correction, a card shows which time on which day will change and how
- Checking mid-month. Ask "Tell me my total overtime so far this month and which days have late-night hours," and it picks them out of the daily records to answer
- Remaining leave. Ask "Tell me how many days of paid leave I have left this fiscal year." It picks paid leave from the list of leave types and answers with the remaining amount from the last row of the grant and usage history
Admins and managers checking company-wide attendance
- Who is in today. Ask "List today's attendance for the whole company, and name the people who have not clocked in"
- Checking overtime at month-end. Ask "From last month's monthly report, group the people whose overtime exceeded the 45-hour bracket by department." The employee list includes departments, so it can group them by department
- Leave usage. Ask "From last month's monthly report, list 10 people in order of the most paid leave remaining"
Acting on the results, such as talking to people or having them fix their attendance, is a person's job. Other employees' attendance cannot be changed from chat.
What you need
- Someone who can issue an API KEY on the HRMOS Kintai admin screen
- An admin or manager in Samurai App (the person who connects HRMOS Kintai)
- Your company string: the company-specific string that follows
https://ieyasu.co/in your HRMOS Kintai login URL - For each user, the email address they sign in to Samurai App with must be registered in their HRMOS Kintai employee information
Steps
1. Issue an API KEY in HRMOS Kintai
Issue an API KEY under "System Administration" → "System Settings" in HRMOS Kintai, and note the Secret Key. The Secret Key is the value used to issue API tokens. Handle it so that it does not leak.
2. An admin connects it in Samurai App
Open the Connectors screen, and on the "API integrations" tab choose HRMOS Kintai from "Add API integration." Enter the "Company string" and the "Secret Key," and press "Connect to HRMOS Kintai."
When the connection is done, "Connected" is shown. Samurai App holds the Secret Key while the connection lasts and uses it to issue a new token when one expires. No expiry warning is shown.
3. Each member verifies their own HRMOS Kintai account
Each person who will use it presses "Verify my HRMOS Kintai account" in the same section once. They are linked to the HRMOS Kintai employee with the same email address, and "In HRMOS Kintai, you operate as [name]" is shown. Admins and managers also do this verification before viewing company-wide attendance.
People who have not verified cannot use HRMOS Kintai from chat.
4. Ask in chat
Show me my attendance this month, day by day.
Pick out only the days with overtime, and tell me the total overtime too
Change my break on November 5 to 12:00 to 13:00. Before you change it, show it side by side with the current record
By default, an approval card appears before clocking in and making corrections. Read the type and time before allowing it.
Things to watch for
Punches are recorded at the time you ask. Even if you say "I came in at 9," the punch itself is the current time. To use a past time, ask for a correction instead of a punch.
Corrections only work on days that already exist in HRMOS Kintai. Only the fields you send change; the other times stay as they are. Requests and approvals after a correction are done on the HRMOS Kintai screen.
Company-wide attendance includes employees' names and email addresses. When you pass the results on to others, choose who receives them and how much.
Disconnecting also removes everyone's identity verification. A confirmation screen appears, and the stored Secret Key and token are discarded. Identity verification is also removed if you reconnect with a different company string without disconnecting. To disable the API KEY itself, delete it on the HRMOS Kintai admin screen. According to HRMOS Kintai's official documentation, deleting an API KEY also deletes every token issued from it.
FAQ
Which plans include the HRMOS Kintai API?
As of November 9, 2026, HRMOS Kintai's pricing page lists the "HRMOS Kintai API" among the basic features of the paid plans. The pricing page did not say whether it is available on the free plan. Check with HRMOS Kintai before signing up.
How is it different from Slack clock-in?
Slack clock-in is a feature provided by HRMOS Kintai that lets you clock in and check a summary as of today with fixed commands. Samurai App differs in that it reads daily records and leave history, and you can ask it to fix a missed punch in the same conversation. Reading company-wide attendance is also something Samurai App does. If clocking in is all you need, Slack clock-in is enough.
Can I let team leaders see only their team's attendance?
No. Only Samurai App admins and managers can read company-wide attendance, and what they can read is the whole company. If you want a team leader to see only their team, an admin or manager passes on just that team's portion of the results.
Is the clock-in location recorded?
Punches from Samurai App carry no location information. Reading punch history in chat does not return a position or address.
Sources
- HRMOS Kintai API definition (HRMOS Kintai, version 1.0.19)
- How to use HRMOS Kintai: Slack clock-in released (HRMOS Kintai, February 14, 2022)
- API integration: how to connect Money Forward Cloud Payroll and HRMOS Kintai (HRMOS Kintai)
- Pricing plans (HRMOS Kintai)
- Connecting outside services (Samurai App guide)
- How to connect each API integration service (Samurai App guide)
We checked HRMOS Kintai's official API documentation, pricing page, and how-to articles as of November 9, 2026.