TimeHunter MCP by usefulapi

Read employee status, attendance, work reports and schedules in TimeHunter.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
89%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,754Tokens (tool definitions)
~1.3 KBTypical response size
Moderate attention impact (1.37% 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": {
    "timehunter": {
      "url": "https://timehunter.usefulapi.io/mcp"
    }
  }
}

Remote endpoints

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

What it can do

Tool inventory

Tools (8)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢timehunter_employee_status

List every employee with their current work state: working, on break, and the start time of today's session. Good first call to get employee ids. TimeHunter API: GET /api/employees/status.

Input Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_get_work_time_today(employee_id)

Get one employee's net working time today in seconds (totalSeconds) and the number of work sessions. TimeHunter API: GET /api/work/today.

Input Schema

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Employee id (UUID) from timehunter_employee_status."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_list_attendance(date, date_from, date_to, employee_id)

List attendance per employee and day: check-in, check-out, break times, work time and location. Defaults to today. Give date, or date_from and date_to together. TimeHunter API: GET /api/attendance.

Input Schema

{
  "type": "object",
  "properties": {
    "date": {
      "description": "One day (YYYY-MM-DD). Default: today.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_from": {
      "description": "First day of a range (YYYY-MM-DD). Use with date_to.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_to": {
      "description": "Last day of a range (YYYY-MM-DD). Use with date_from.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "employee_id": {
      "description": "Employee id (UUID). Omit for all employees.",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_get_daily_report(employee_id)

Get one employee's report for today: net work seconds and each work session with start, end and break times. The API always reports today and ignores other dates. TimeHunter API: GET /api/report/daily.

Input Schema

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Employee id (UUID) from timehunter_employee_status."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_get_weekly_report(employee_id)

Get one employee's work seconds per day for the current week (dailyTotals). TimeHunter API: GET /api/report/weekly.

Input Schema

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Employee id (UUID) from timehunter_employee_status."
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_get_monthly_report(employee_id, month)

Get one employee's work seconds per day for a month (dailyTotals, days with work only). Defaults to the current month. TimeHunter API: GET /api/report/monthly.

Input Schema

{
  "type": "object",
  "properties": {
    "employee_id": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Employee id (UUID) from timehunter_employee_status."
    },
    "month": {
      "description": "Month (YYYY-MM). Default: current month.",
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
    }
  },
  "required": [
    "employee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_get_period_summary(months, date_from, date_to, employees, detail)

Get a summary per employee and month: work hours, norm, overtime, balance, late arrivals, absence days by type, and weekend or holiday work. Defaults to the previous and current month. TimeHunter API: GET /api/report/summary.

Input Schema

{
  "type": "object",
  "properties": {
    "months": {
      "description": "Comma-separated months (YYYY-MM). Max 13.",
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])(,\\d{4}-(0[1-9]|1[0-2])){0,12}$"
    },
    "date_from": {
      "description": "Start of a date range (YYYY-MM-DD). Use with date_to instead of months.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "date_to": {
      "description": "End of a date range (YYYY-MM-DD). Use with date_from instead of months.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "employees": {
      "description": "Comma-separated employee names or UUIDs. Omit for all active employees.",
      "type": "string",
      "maxLength": 1000
    },
    "detail": {
      "description": "true adds one row per day (in/out, lateness, day type).",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢timehunter_list_schedules(year, month, employee_ids)

List work schedules for one month: each day's planned start and end, and the actual presence (arrival, departure, session id). TimeHunter API: GET /api/schedules.

Input Schema

{
  "type": "object",
  "properties": {
    "year": {
      "type": "integer",
      "minimum": 2000,
      "maximum": 2100,
      "description": "Year, for example 2026."
    },
    "month": {
      "type": "integer",
      "minimum": 1,
      "maximum": 12,
      "description": "Month, 1 to 12."
    },
    "employee_ids": {
      "description": "Comma-separated employee UUIDs. Omit for all employees.",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}(,[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}){0,199}$"
    }
  },
  "required": [
    "year",
    "month"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded8 tools