Skip to content
MCP server

TimeHunter MCP by usefulapi

Read-only MCP connector to TimeHunter attendance, work time and schedules for AI clients

Install
Pricing
Freemium
Platforms
Web, API
Runs
Remotely
Version
1.1.1
Listing updated
today

About TimeHunter MCP by usefulapi

TimeHunter MCP by usefulapi is a freemium MCP server for hiring and recruiting. It runs as a hosted remote server, so there is nothing to install locally.

The README and product page describe a hosted MCP endpoint that lets an AI client query a TimeHunter account for employee presence, attendance records, work-time reports and shift schedules. Access runs through OAuth, and the login page asks for a TimeHunter API key that a company admin creates in the TimeHunter settings.

The server exposes eight read-only tools for status, attendance, daily, weekly, monthly and period reports, and schedules, plus four utility tools for usage, feature requests and subscription management. Requests are metered per month against a free allowance, with paid Pro and Pro+ tiers that cover only this server.

It suits HR staff and managers who want to ask an assistant about who is working, overtime or late arrivals without opening TimeHunter. The page states that usefulapi is an independent service and not affiliated with TimeHunter.

Install

Run in a terminal

claude mcp add --transport http timehunter https://timehunter.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://timehunter.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "timehunter": {
      "url": "https://timehunter.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "timehunter": {
      "type": "http",
      "url": "https://timehunter.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "timehunter": {
      "serverUrl": "https://timehunter.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "timehunter": {
      "type": "http",
      "url": "https://timehunter.usefulapi.io/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

timehunter_employee_status
List every employee with their current work state and the start time of today's session.
timehunter_get_work_time_today
Get one employee's net working time today in seconds and the number of work sessions.
timehunter_list_attendance
List attendance per employee and day, including check-in, check-out, break times, work time and location.
timehunter_get_daily_report
Get one employee's report for today with net work seconds and each work session.
timehunter_get_weekly_report
Get one employee's work seconds per day for the current week.
timehunter_get_monthly_report
Get one employee's work seconds per day for a month.
timehunter_get_period_summary
Get work hours, norm, overtime, balance, late arrivals and absence days per employee and month.
timehunter_list_schedules
List planned start and end times for each day of a month alongside actual presence.
timehunter_usage_status
Report the caller's current usage against the plan limit.
timehunter_request_feature
Send a request to usefulapi for a capability the TimeHunter tools cannot provide.
timehunter_upgrade
Obtain a paid Pro or Pro+ plan payment link for TimeHunter.
timehunter_cancel_subscription
Cancel the Pro subscription at the end of the paid period.

What it does

Live employee status
Lists each employee's current work state, such as working or on break, and the start of today's session.
Attendance records
Returns check-in, check-out, break times, work time and location per employee and day, for a single date or range.
Daily and weekly reports
Provides net work seconds and session breakdowns for one employee for today, plus daily totals for the current week.
Monthly and period summaries
Summarises work hours, norm, overtime, balance, late arrivals and absence days by month.
Schedule comparison
Shows planned shift start and end times next to actual arrival and departure for a month.
Read-only access
All eight data tools are marked read-only, so the assistant cannot change TimeHunter records.

Good for

  • Check which employees are currently working or on a break
  • Review team attendance for a given day or date range
  • Calculate one employee's monthly hours and overtime balance
  • Find late arrivals in a past month
  • Compare planned shifts against actual presence

Pricing

Freemium, from $9 a month

Free plan with 50 calls/month; Pro from $9/mo or $90/yr; Pro+ $39/mo or $390/yr

Prices change. Check usefulapi.io before you buy.

TimeHunter MCP by usefulapi FAQ

Is this an official TimeHunter product?

No. The product page says usefulapi is an independent service and is not affiliated with or endorsed by TimeHunter.

Can the AI change my TimeHunter data?

No. The page states that all 8 TimeHunter data tools are marked read-only.

What do I need to connect?

The login page asks for a TimeHunter API key, which a company admin creates in TimeHunter under Klucze API.

What does it cost?

The Free plan allows 50 tool calls per month. Pro is $9/mo or $90/yr with 10,000 calls, and Pro+ is $39/mo or $390/yr with 100,000 calls.

Is TimeHunter MCP by usefulapi free?

TimeHunter MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

How do I add TimeHunter MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http timehunter https://timehunter.usefulapi.io/mcp

What are the best alternatives to TimeHunter MCP by usefulapi?

The closest alternatives to TimeHunter MCP by usefulapi are Reactive Resume, OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages, Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions, Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs and Workable Jobs Scraper & API - All Companies, Remote, 24 Hours.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to TimeHunter MCP by usefulapi

  1. Reactive Resume

    MCP server

    Open-source resume and cover letter builder with job tracking and an MCP endpoint

    • Remote
    • Open source
    • Hiring and recruiting