TimeStation MCP by usefulapi

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

Should I use this

Quality & Safety

A
Description quality
96%
Schema completeness
87%
Naming quality
78%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

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

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,916Tokens (tool definitions)
~1.2 KBTypical response size
Moderate attention impact (1.50% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "timestation": {
      "url": "https://timestation.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (11)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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.

Input 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}.

Input 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.

Input 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.

Input 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}.

Input 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.

Input 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}.

Input 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}.

Input 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.

Input 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.

Input 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.

Input 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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools