TimeStation MCP by usefulapi

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

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
96%
Vollständigkeit des Schemas
87%
Qualität der Benennung
78%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'timestation_list_employee_departments' name length outside 3-30 rangein timestation_list_employee_departments

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~1,916Tokens (Tool-Definitionen)
~1.2 KBTypische Antwortgröße
Mittlere Auswirkung auf die Aufmerksamkeit (1.50% von 128k Kontext)

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": {
    "timestation": {
      "url": "https://timestation.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

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

Was es kann

Tool-Inventar

Tools (11)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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}.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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.

Eingabe-Schema

{
  "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"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet11 Tools