TotemClock MCP by usefulapi
io.usefulapi/totemclock · v1.2.0 · MCP 2025-11-25
Read employees, punches, timecards and timesheets; record punches in TotemClock.
Reachability
reachable
checked 2026-11-21 05:35 UTC
Registry status active
Tools pinned 10
69c8f38fd4da
Tools last changed
unchanged since first capture 2026-11-17
Repo last push 2026-11-21
as of 2026-11-21
GitHub stars 1
as of 2026-11-21
Provenance
Registry namespace io.usefulapi
(domain verified by the official registry)
Repository
github.com/m190/usefulapi-mcp
Website
https://usefulapi.io/totemclock/
Remote endpoints
https://totemclock.usefulapi.io/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-17 05:30 | first capture | 10 tools pinned |
Pinned tool definitions (10)
| Tool | Description |
|---|---|
| totemclock_get_organization | Return the company that owns the API key: name, slug, and timezone. Good first call to confirm which company is connected. TotemClock API: GET /api/v1/organization. |
| totemclock_list_employees | List active employees with code, name, job title, department, hire and termination dates, and attendance mode (SCHEDULED, SINGLE_DAILY, EXEMPT, ACTUAL). Use the id in the other tools. TotemClock API: GET /api/v1/employees. |
| totemclock_list_sites | List active company sites with address, punch policy (NONE, GEO, QR, GEO_OR_QR, GEO_AND_QR), and geofence radius in meters. TotemClock API: GET /api/v1/sites. |
| totemclock_list_schedules | List active work schedules and which employees each one is assigned to. TotemClock API: GET /api/v1/schedules. |
| totemclock_list_punches | List raw clock punches (CLOCK_IN, CLOCK_OUT, BREAK_START, BREAK_END) in a date-time range, optionally for one employee. Range is required. TotemClock API: GET /api/v1/punches. |
| totemclock_create_punch | Record one clock punch for an employee (CLOCK_IN, CLOCK_OUT, BREAK_START, BREAK_END) at occurredAt. externalId makes the call safe to retry: the same externalId and payload return the existing punch. Needs the punches:write scope.... |
| totemclock_get_employee_day | Return one employee's punches and calculated result for one day: first in, last out, worked, target, overtime, late and early-leave minutes, and anomalies. TotemClock API: GET /api/v1/employees/{employeeId}/days/{date}. |
| totemclock_list_timecards | Return the calculated daily timecard rows for all employees on one day (default: today in the company timezone). TotemClock API: GET /api/v1/timecards. |
| totemclock_get_monthly_timecard | Return one employee's calculated monthly timecard: each day, the causes behind the results, and monthly totals. TotemClock API: GET /api/v1/monthly-timecards. |
| totemclock_get_timesheet | Return one employee's monthly timesheet: the hours and activities assigned to customers, projects and work, with the total minutes. TotemClock API: GET /api/v1/timesheets. |
Get alerted when this changes.
Email the moment io.usefulapi/totemclock drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.usefulapi/totemclock)
Maintain this server? Add the badge to your README. It links your users to this live status page.