Timetaag MCP by usefulapi
Read employees, leave, attendance, punches, shifts and holidays in Timetaag.
Sollte ich dies verwenden
Qualität und Sicherheit
Befunde (1)
- LOWin timetaag_list_shift_assignments
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"timetaag": {
"url": "https://timetaag.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://timetaag.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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}.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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.
Eingabe-Schema
{
"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>.
Eingabe-Schema
{
"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"
}Community
Nachweis