TimeStation MCP by usefulapi
Read employees, shifts and reports, and create employees or close shifts in TimeStation.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWtimestation_list_employee_departments에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}커뮤니티
증거