Kintai Plus (unofficial)

Raw punch issues for yourself (打刻漏れチェック): missing clock-out/in, break left open, no punches on a workday, days over 12 hours, rest under 11 hours (勤務間インターバル), holiday work. Does NOT check Labor Standards Act break length (6h/45min, 8h/60min), man-hours, or the monthly overtime trajectory — close_out does, in one call. A missing punch is suppressed when the working record already has that time. Defaults: the 1st of this month through yesterday (on the 1st, the previous month), Japan time, YYYY-MM-DD, max 93 days. Today is excluded because the day may still be open. Overnight shifts are recognized. Leave is invisible, so "no punches" may be a day off. Fixing punches is 修正申請 in the web UI, not punch.

One read-only call for what you still need to do before closing a day or a month (1日の締め / 月末の締め). Returns a priority list: missing clock-out or break-end (退勤・休憩戻), a break shorter than the Labor Standards Act (over 6h worked needs 45 min, over 8h needs 60 min — a 3-minute lunch punch is not enough), man-hours missing or not matching time worked (工数), the monthly overtime estimate (法定時間外の目安), and alerts. Use this INSTEAD OF chaining get_today_status, check_attendance_issues, get_manhours, summarize_working_hours, and get_alerts. scope "day" (default) is one day, default today in Japan (Asia/Tokyo). scope "month" is that month through today, or the whole month if it has ended. Dates are YYYY-MM-DD. Months are YYYY-MM (01-12). When ok is true and items is empty, tell the user nothing else is required (headline says 対応は不要). Follow items in priority order. If action says 修正申請, do NOT call punch — the API cannot edit past stamps. This tool never punches or saves. Writes still need punch / save_manhours / delete_manhours after the user confirms.

WRITE. Delete YOUR man-hours (工数) for one date (YYYY-MM-DD, Japan time) and projectId. If taskId is omitted, ALL tasks of that project on that day are deleted — confirm that explicitly with the user. Idempotent: deleting what is already gone returns deleted:false and changes nothing. Closed (締め) or fixed (確定) days cannot be changed; do not retry. If this tool is not listed, the server is read-only (KINTAI_PLUS_READ_ONLY).

Raw attendance alerts (アラート) Kintai Plus already raised for you: 打刻忘れ, 欠勤疑い, 遅刻, 早退, 残業時間閾値超え, 36協定, 工数未入力, 休憩不足, and others. The API cannot filter; month (YYYY-MM, Japan time) is applied here. Omit month for every month the API returns. close_out already folds the relevant alerts into a prioritized list — call get_alerts only when you need the raw rows.

Static rules for this server (not your live data): punch types (打刻種別: 出勤 clock_in, 退勤 clock_out, 直行 direct_in, 直帰 direct_out, 休憩入 break_start, 休憩戻 break_end), why a punch cannot be edited via the API (修正申請), and the statutory break (法定休憩: over 6h needs 45 min, over 8h needs 60 min). Same text as the kintai://guide resource. For today, call get_today_status. For the day or month checklist, call close_out. No arguments.

Your man-hours (工数) per day, project, and task, in minutes, with names when the directory can be loaded. Defaults: from=the 1st of this month, to=the end of that month (Japan time, YYYY-MM-DD), max 93 days. closed (締め) or fixed (確定) days cannot be changed with save_manhours or delete_manhours. close_out says which days are missing or off; call this to see the entries before changing them.

Who is signed in, and what is today in Japan? Returns staff ID, name, organization (所属), and role (company_admin 企業管理者 / admin 一般管理者 / employee 従業員), plus today (YYYY-MM-DD) and timezone Asia/Tokyo. Call this to learn the role before assuming admin tools exist. For what to do before leaving or at month-end, use close_out instead.

Projects you belong to (参加プロジェクト), with names. Prefer this over list_projects when entering your own man-hours. If a name is missing, the project list could not be loaded; the projectId is still valid for list_tasks and save_manhours.

Raw punch history (打刻履歴) for yourself: clock_in 出勤, clock_out 退勤, direct_in/out 直行/直帰, break_start/end 休憩入/休憩戻. Defaults: from=today, to=from, Japan time (YYYY-MM-DD). Max 366 days, fetched in chunks. Use get_today_status for today's state in one glance, and close_out for what to fix. Use this when you need the timestamps. Location and IP are omitted unless KINTAI_PLUS_INCLUDE_LOCATION=true.

Live status for today only (Japan time, Asia/Tokyo): not_started 未出勤 / working 勤務中 / on_break 休憩中 / finished 退勤済み, minutes worked so far (breaks excluded), break minutes, and today's punches. No arguments; "today" is never a date you pass. Call this immediately before punch to see which type is legal. For the end-of-day checklist (short breaks, man-hours, overtime, alerts), use close_out scope=day instead of chaining tools. Not 勤務処理 labels such as 欠勤 or 出張 — that admin tool is get_working_treatments.

Daily working records (勤務実績): day category (労働日 / 所定休日 / 法定休日), start/end, punch times. staffIds is optional and defaults to yourself (omit it for the signed-in person; the response then has no staffId, same as before). Admins may pass staff they manage (from list_staff), up to 50 per request. When the API returns net minutes, actualWorkingMinutes is that value. When it does not, actualWorkingMinutes stays the elapsed start-to-end and estimatedNetMinutes subtracts known breaks or, if breaks are missing, the statutory minimum (over 6h → 45 min, over 8h → 60 min). That second figure is an estimate (estimateNote). Defaults: the 1st of this month through today (Japan time, YYYY-MM-DD). Split into 31-day requests (max 366 days). No overtime field — summarize_working_hours for your totals, close_out for what you should fix, team_close_out for the team. Do not call this once per person to close a team.

Search the company project list (プロジェクト) used for man-hours (工数). Prefer get_my_projects when logging your own time; use this to search by name or code, or to see projects you might not belong to. activeOn is YYYY-MM-DD (Japan time) and keeps projects whose period includes that date. projectId goes to list_tasks and save_manhours.

Tasks (タスク) of one projectId from get_my_projects or list_projects. Call this before save_manhours so taskId is real. Finished tasks (終了) are hidden unless includeFinished is true. estimatedMinutes is minutes (estimatedHours is the same value as H:MM).

WRITE now (打刻). type is required: clock_in 出勤, clock_out 退勤, direct_in 直行, direct_out 直帰, break_start 休憩入, break_end 休憩戻. Recorded at the time Kintai Plus receives it. CANNOT be edited, deleted, or backdated — a mistake needs 修正申請 in the web UI, not another punch. Not idempotent: every successful call adds a stamp. Confirm the type with the user. Call get_today_status or close_out first. Conflicts with today (for example clock_in while already working, or clock_out while on a break) are refused; the error names the legal next type. force: true only when the user explicitly insists. If this tool is not listed, the server is read-only (KINTAI_PLUS_READ_ONLY) — tell the user, do not retry.

WRITE. Create or update YOUR man-hours (工数) for one date (YYYY-MM-DD, Japan time): minutes per project task. Only the tasks you list are overwritten; other tasks that day are kept. Removing an entry is delete_manhours, not a zero. Confirm the project, task, and minutes with the user before calling. Idempotent for the same entries. Refuses a day that is closed (締め) or fixed (確定) — do not retry; it must be reopened in the web UI. Find IDs with get_my_projects (prefer it over list_projects) and list_tasks. close_out tells you which dates are missing. If this tool is not listed, the server is read-only (KINTAI_PLUS_READ_ONLY).

Totals for yourself over a period: working minutes, work days (出勤日数), holiday-work days (休日出勤), and an ESTIMATE of statutory overtime (法定時間外の目安), per month. Defaults: the 1st of this month through today, Japan time, YYYY-MM-DD (max 366 days). Always repeat disclaimer to the user; the number is not an official overtime total. Team risk is find_overtime_risks (admin). What the employee should fix is close_out, which already includes this estimate.