Timetaag MCP by usefulapi
Read employees, leave, attendance, punches, shifts and holidays in Timetaag.
使うべきか
品質と安全性
検出事項(1)
- LOWtimetaag_list_shift_assignments 内
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"timetaag": {
"url": "https://timetaag.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://timetaag.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール(14)
🟢timetaag_list_employees(status, emp_code, search, branch_id, department_id, ...)
List employees with their branch, department, designation, location and shift groups. Working employees by default; set status to resigned or all. Timetaag API: GET /api/v2/employees.
入力スキーマ
{
"type": "object",
"properties": {
"status": {
"description": "Default active.",
"type": "string",
"enum": [
"active",
"resigned",
"all"
]
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"search": {
"description": "Part of the name or code.",
"type": "string"
},
"branch_id": {
"description": "Filter by branch id (from timetaag_list_setup kind branches).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"department_id": {
"description": "Filter by department id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"location_id": {
"description": "Filter by location id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"section_id": {
"description": "Filter by section id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"designation_id": {
"description": "Filter by designation id.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Only records changed at or after this time, yyyy-mm-dd hh:mm:ss (company time zone). Use it for syncs."
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_get_employee(emp_code)
Get one employee by employee code, with the same fields as the list. Timetaag API: GET /api/v2/employees/{emp_code}.
入力スキーマ
{
"type": "object",
"properties": {
"emp_code": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Employee code, for example 101."
}
},
"required": [
"emp_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_leave_types(date)
List the leave types the company uses, for example annual or sick leave. Timetaag API: GET /api/v2/leave-types.
入力スキーマ
{
"type": "object",
"properties": {
"date": {
"description": "Leave types valid on this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_leave_balances(emp_code, leave_type_id, date)
List the leave balances of one employee, per leave type. Timetaag API: GET /api/v2/leave-balances.
入力スキーマ
{
"type": "object",
"properties": {
"emp_code": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Employee code, for example 101. Several codes: separate with commas."
},
"leave_type_id": {
"description": "Only this leave type (from timetaag_list_leave_types).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"date": {
"description": "Balances on this date (default today).",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
}
},
"required": [
"emp_code"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_leaves(from, to, emp_code, status, leave_type_id, ...)
List leave entries that touch a date range, with status pending, approved or declined. Deleted leaves are left out. Timetaag API: GET /api/v2/leaves.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"pending",
"approved",
"declined"
]
},
"leave_type_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Only records changed at or after this time, yyyy-mm-dd hh:mm:ss (company time zone). Use it for syncs."
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_get_leave(id)
Get one leave entry by its id. Timetaag API: GET /api/v2/leaves/{id}.
入力スキーマ
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Leave id, from timetaag_list_leaves."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_daily_attendance(from, to, emp_code, per_page, page)
List the calculated daily attendance (in, out, worked time, late and early marks) for a date range. Reports need a plan that includes them (HTTP 403 otherwise). Timetaag API: GET /api/v2/attendance/daily.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_punches(from, to, emp_code, serial_number, updated_since, ...)
List the raw clock punches (biometric device and manual) for a date range. Timetaag API: GET /api/v2/punches.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"serial_number": {
"description": "Only punches from this device serial number.",
"type": "string"
},
"updated_since": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2} \\d{2}:\\d{2}:\\d{2}$",
"description": "Only records changed at or after this time, yyyy-mm-dd hh:mm:ss (company time zone). Use it for syncs."
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_shift_assignments(from, to, emp_code, per_page, page)
List which shift each employee works on each day in a date range. Timetaag API: GET /api/v2/shift-assignments.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_holidays(year, holiday_group_id)
List public holidays, for one year or one holiday group. Timetaag API: GET /api/v2/holidays.
入力スキーマ
{
"type": "object",
"properties": {
"year": {
"description": "Holiday year, for example 2026.",
"type": "integer",
"minimum": 1900,
"maximum": 2999
},
"holiday_group_id": {
"description": "Only this holiday group (from timetaag_list_setup kind holiday-groups).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_regularizations(from, to, emp_code, status, per_page, ...)
List attendance regularization requests (corrections of punches) in a date range, with their status. Timetaag API: GET /api/v2/regularizations.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"pending",
"approved",
"declined"
]
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_work_requests(from, to, emp_code, type, status, ...)
List work requests (for example on-duty or out-of-office) in a date range, with their type and status. Timetaag API: GET /api/v2/work-requests.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"type": {
"description": "The request type, as Timetaag names it.",
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pending",
"approved",
"declined",
"cancelled"
]
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_expense_claims(from, to, emp_code, status, per_page, ...)
List expense claims in a date range, with their status and payout status. Timetaag API: GET /api/v2/expense-claims.
入力スキーマ
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, yyyy-mm-dd."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, yyyy-mm-dd (at most 62 or 366 days after from, depending on the endpoint)."
},
"emp_code": {
"description": "Employee code, for example 101. Several codes: separate with commas.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"pending",
"approved",
"declined",
"cancelled"
]
},
"per_page": {
"description": "Results per page, 1 to 200 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢timetaag_list_setup(kind)
List one kind of company setup: branches, departments, designations, locations, sections, teams, employment-types, biometric-groups, shifts, holiday-groups or devices. Use the ids in employee and leave filters. Timetaag API: GET /api/v2/<kind>.
入力スキーマ
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"branches",
"departments",
"designations",
"locations",
"sections",
"teams",
"employment-types",
"biometric-groups",
"shifts",
"holiday-groups",
"devices"
],
"description": "The setup list to read."
}
},
"required": [
"kind"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}コミュニティ
エビデンス