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 件