TotemClock MCP by usefulapi

Read employees, punches, timecards and timesheets; record punches in TotemClock.

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
71%
이름 품질
78%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (1)

  • LOWTool 'totemclock_get_monthly_timecard' name length outside 3-30 rangetotemclock_get_monthly_timecard에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~2,177토큰 (도구 정의)
~1.2 KB일반적인 응답 크기
중간 정도의 주의 영향 (128k 컨텍스트의 1.70%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "totemclock": {
      "url": "https://totemclock.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://totemclock.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (10)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢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.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢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.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢totemclock_list_schedules

List active work schedules and which employees each one is assigned to. TotemClock API: GET /api/v1/schedules.

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢totemclock_list_punches(from, to, employeeId, limit)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "Start of the range (inclusive)."
    },
    "to": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "End of the range (exclusive)."
    },
    "employeeId": {
      "description": "Only punches for this employee id.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "limit": {
      "description": "Maximum punches to return (1-500, default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "required": [
    "from",
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡totemclock_create_punch(externalId, employeeId, type, occurredAt, siteId, ...)

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 API: POST /api/v1/punches.

입력 스키마

{
  "type": "object",
  "properties": {
    "externalId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Your own unique id for this punch, unique inside the company. Reuse it on retries."
    },
    "employeeId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The employee id (from totemclock_list_employees)."
    },
    "type": {
      "type": "string",
      "enum": [
        "CLOCK_IN",
        "CLOCK_OUT",
        "BREAK_START",
        "BREAK_END"
      ],
      "description": "Punch type."
    },
    "occurredAt": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "When the punch happened, with offset, e.g. 2026-09-09T08:00:00+02:00."
    },
    "siteId": {
      "description": "Site id (from totemclock_list_sites), if the punch has a site.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "note": {
      "description": "Free-text note, max 500 characters.",
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "externalId",
    "employeeId",
    "type",
    "occurredAt"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢totemclock_get_employee_day(employeeId, date)

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}.

입력 스키마

{
  "type": "object",
  "properties": {
    "employeeId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The employee id (from totemclock_list_employees)."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "The day, yyyy-mm-dd."
    }
  },
  "required": [
    "employeeId",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢totemclock_list_timecards(date)

Return the calculated daily timecard rows for all employees on one day (default: today in the company timezone). TotemClock API: GET /api/v1/timecards.

입력 스키마

{
  "type": "object",
  "properties": {
    "date": {
      "description": "The day, yyyy-mm-dd. Omit for the company's current day.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢totemclock_get_monthly_timecard(month, employeeId)

Return one employee's calculated monthly timecard: each day, the causes behind the results, and monthly totals. TotemClock API: GET /api/v1/monthly-timecards.

입력 스키마

{
  "type": "object",
  "properties": {
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
      "description": "The month, yyyy-mm."
    },
    "employeeId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The employee id (from totemclock_list_employees)."
    }
  },
  "required": [
    "month",
    "employeeId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢totemclock_get_timesheet(month, employeeId)

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.

입력 스키마

{
  "type": "object",
  "properties": {
    "month": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
      "description": "The month, yyyy-mm."
    },
    "employeeId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The employee id (from totemclock_list_employees)."
    }
  },
  "required": [
    "month",
    "employeeId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 10개