TimeStation MCP by usefulapi

Read employees, shifts and reports, and create employees or close shifts in TimeStation.

사용해야 할까요

품질 및 안전성

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

발견 사항 (1)

  • LOWTool 'timestation_list_employee_departments' name length outside 3-30 rangetimestation_list_employee_departments에서

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

컨텍스트 비용

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

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

설치

원클릭 설치

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

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

원격 엔드포인트

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

할 수 있는 일

도구 목록

도구 (11)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢timestation_list_employees

List all employees in the TimeStation account with their current status (in/out), primary and current department, and custom employee id. Good first call. GET /employees.

입력 스키마

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

Get the details of one employee, including status, departments, and custom fields. GET /employees/{employee_id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timestation_list_employee_departments(employee_id)

List the departments an employee belongs to (primary and secondary). GET /employees/{employee_id}/departments.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timestation_list_departments

List all departments in the TimeStation account. GET /departments.

입력 스키마

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

Get the details of one department. GET /departments/{department_id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "department_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    }
  },
  "required": [
    "department_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timestation_list_shifts(employee_id, start_date, end_date)

List the shifts of one employee (check-in and check-out times, total minutes, notes), optionally within a date range. GET /shifts.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timestation_get_shift(shift_id)

Get the details of one shift, including its check-in and check-out times. GET /shifts/{shift_id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "shift_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    }
  },
  "required": [
    "shift_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timestation_run_report(report_id, start_date, end_date, day_date)

Run a TimeStation report and return it as CSV (first row is the header). Examples: AttendanceOnly, CurrentEmployeeStatus, DepartmentList, DepartmentSummary, DailyAttendanceAbsence (use day_date). Pass start_date and end_date for date-range reports. GET /reports/{report_id}.

입력 스키마

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9]+$",
      "description": "Report identifier, e.g. DepartmentList."
    },
    "start_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD."
    },
    "end_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD."
    },
    "day_date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Date, YYYY-MM-DD."
    }
  },
  "required": [
    "report_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴timestation_create_employee(name, department_id, department_name, custom_employee_id, title, ...)

Create a new employee. Provide department_id or department_name (a new department is created when the name is unknown). Creates a record: this is not idempotent. POST /employees.

입력 스키마

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Employee name."
    },
    "department_id": {
      "description": "Existing primary department id. Give this or department_name.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$"
    },
    "department_name": {
      "description": "Primary department name. Give this or department_id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "custom_employee_id": {
      "description": "Second employee id, for a record in another system.",
      "type": "string",
      "maxLength": 100
    },
    "title": {
      "description": "Job title.",
      "type": "string",
      "maxLength": 200
    },
    "hourly_rate": {
      "description": "Hourly rate, e.g. 25.00.",
      "type": "string",
      "pattern": "^\\d+(\\.\\d{1,2})?$"
    },
    "pin": {
      "description": "4-digit clock PIN.",
      "type": "string",
      "pattern": "^\\d{4}$"
    },
    "custom_fields": {
      "description": "Existing employee custom fields, by field name.",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴timestation_check_out_employee(employee_id, time_out, notes, time_deduction_minutes)

Check out an employee: close the employee's current open shift at time_out (or now). It acts on whatever shift is open, so do not retry blindly after a success. PUT /employees/{employee_id}/check-out.

입력 스키마

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    },
    "time_out": {
      "description": "Check-out time, ISO-8601 with a UTC offset (e.g. 2025-07-12T17:00-05:00). Omit for the current time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(Z|[+-]\\d{2}:?\\d{2})$"
    },
    "notes": {
      "description": "Free-text notes.",
      "type": "string",
      "maxLength": 500
    },
    "time_deduction_minutes": {
      "description": "Minutes to deduct from the shift. Overrides the automatic deduction rules for this shift.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟡timestation_close_shift(shift_id, time_out, notes, time_deduction_minutes)

Close an open shift at time_out (or now). PUT /shifts/{shift_id}/close.

입력 스키마

{
  "type": "object",
  "properties": {
    "shift_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]+$",
      "description": "TimeStation id."
    },
    "time_out": {
      "description": "Check-out time, ISO-8601 with a UTC offset (e.g. 2025-07-12T17:00-05:00). Omit for the current time.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(:\\d{2})?(Z|[+-]\\d{2}:?\\d{2})$"
    },
    "notes": {
      "description": "Free-text notes.",
      "type": "string",
      "maxLength": 500
    },
    "time_deduction_minutes": {
      "description": "Minutes to deduct from the shift. Overrides the automatic deduction rules for this shift.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "shift_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

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