# TimeHunter MCP by usefulapi

> TimeHunter MCP by usefulapi is a freemium MCP server for hiring and recruiting. Read-only MCP connector to TimeHunter attendance, work time and schedules for AI clients. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** Web, API
- **Website:** https://usefulapi.io/timehunter/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timehunter
- **MCP Registry name:** io.usefulapi/timehunter
- **Categories:** hiring and recruiting
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://timehunter.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "timehunter": {
      "url": "https://timehunter.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages](https://ai-powered.com/mcp/onlinejobs-ph-scraper-apify-philippine-remote-and-va-jobs-wi): OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages is a paid MCP server for web search and scraping.
- [Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions](https://ai-powered.com/mcp/gupy-jobs-scraper-apify-brazil-jobs-with-descriptions): Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions is a freemium MCP server for web search and scraping.
- [Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs](https://ai-powered.com/mcp/y-combinator-jobs-scraper-and-api-work-at-a-startup-yc-jobs): Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs is a freemium MCP server for web search and scraping.
- [Workable Jobs Scraper & API - All Companies, Remote, 24 Hours](https://ai-powered.com/mcp/workable-jobs-scraper-and-api-all-companies-remote-24-hours): Workable Jobs Scraper & API - All Companies, Remote, 24 Hours is a freemium MCP server for web search and scraping.
- [Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours](https://ai-powered.com/mcp/lever-jobs-scraper-and-api-salary-remote-last-24-hours): Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours is a paid MCP server for web search and scraping.
- [Workday Jobs Scraper & API - All Companies, Last 24 Hours](https://ai-powered.com/mcp/workday-jobs-scraper-and-api-all-companies-last-24-hours): Workday Jobs Scraper & API - All Companies, Last 24 Hours is a freemium MCP server for web search and scraping.
- [HeyRole](https://ai-powered.com/mcp/heyrole): HeyRole is a free MCP server for hiring and recruiting.

---
Source: https://ai-powered.com/mcp/timehunter-mcp-by-usefulapi
