# Timetaag MCP by usefulapi

> Timetaag MCP by usefulapi is a freemium MCP server for hr and payroll. Hosted MCP connector that lets AI assistants read Timetaag HR, leave and attendance data. 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, CLI, vscode
- **Website:** https://usefulapi.io/timetaag/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timetaag
- **MCP Registry name:** io.usefulapi/timetaag
- **Categories:** hr and payroll, time tracking
- **Listing updated:** 2026-11-18

## About

The server gives Claude, ChatGPT, Cursor and other MCP clients read access to a Timetaag account, covering employees, leave requests and balances, daily attendance, raw clock punches, shift assignments, public holidays, regularization and work requests, expense claims and setup lists such as branches and shifts. The README describes it as read only, and the 14 data tools are marked that way.

The server is hosted by usefulapi, so there is nothing to install locally. Users sign in through an OAuth login page and supply a Timetaag API key with the read scope, which a super admin creates under Master Setup and API Settings. The site says the credentials are stored encrypted and used only to call the Timetaag API on the user's behalf.

It suits HR and workforce teams that already use Timetaag and want to ask questions in plain language, such as who is on leave next week or what a given employee's attendance looked like last month. usefulapi describes itself as independent and not affiliated with Timetaag.

## Features

- **Read-only Timetaag data access:** Fourteen tools list and fetch employees, leaves, attendance, punches, shifts, holidays and related records.
- **Hosted remote MCP endpoint:** Connects over Streamable HTTP with OAuth login, so no local install or config file keys are needed.
- **Leave and balance lookup:** Lists leave entries by date range and status, plus leave balances per employee and leave type.
- **Daily attendance reports:** Shows in and out times, worked time and late or early marks for a date range, on plans that include reports.
- **Punch and correction review:** Lists raw biometric and manual punches and attendance regularization requests with their status.
- **Usage metering with tiered plans:** A free tier of 50 tool calls a month, with paid Pro and Pro+ tiers for higher limits.

## Good for

- Check which employees are on approved leave during a chosen week
- Pull a month of daily attendance for one employee to review late or early marks
- Review pending punch corrections and regularization requests
- Look up public holidays for a holiday group when planning schedules
- Check shift assignments and work requests such as on-duty or out-of-office

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `timetaag_list_employees`: List employees with their branch, department, designation, location and shift groups.
- `timetaag_get_employee`: Get one employee by employee code.
- `timetaag_list_leave_types`: List the leave types the company uses.
- `timetaag_list_leave_balances`: List leave balances of one employee, per leave type.
- `timetaag_list_leaves`: List leave entries touching a date range, with status.
- `timetaag_get_leave`: Get one leave entry by its id.
- `timetaag_list_daily_attendance`: List calculated daily attendance for a date range.
- `timetaag_list_punches`: List raw clock punches for a date range.
- `timetaag_list_shift_assignments`: List which shift each employee works on each day.
- `timetaag_list_holidays`: List public holidays for a year or holiday group.
- `timetaag_list_regularizations`: List attendance regularization requests in a date range.
- `timetaag_list_work_requests`: List work requests such as on-duty or out-of-office.
- `timetaag_list_expense_claims`: List expense claims in a date range with status.
- `timetaag_list_setup`: List one kind of company setup item, such as branches or shifts.

## FAQ

### Is this an official Timetaag product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Timetaag.

### Can the AI change my Timetaag data?

No. All 14 Timetaag data tools are marked read-only.

### What do I need to connect?

The login page asks for a Timetaag API key with the read scope, created by a super admin under Master Setup and API Settings.

### Which AI clients can I use?

Any client that supports remote MCP servers over Streamable HTTP with OAuth login, including Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex.

### Is Timetaag MCP by usefulapi free?

Timetaag 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 Timetaag MCP by usefulapi to Claude Code?

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

### What are the best alternatives to Timetaag MCP by usefulapi?

The closest alternatives to Timetaag MCP by usefulapi are clockin MCP by usefulapi, Breathe HR MCP by usefulapi, Homebase MCP by usefulapi, Workyard MCP by usefulapi and TalentHR MCP by usefulapi.

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

- [clockin MCP by usefulapi](https://ai-powered.com/mcp/clockin-mcp-by-usefulapi): clockin MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Breathe HR MCP by usefulapi](https://ai-powered.com/mcp/breathe-hr-mcp-by-usefulapi): Breathe HR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Homebase MCP by usefulapi](https://ai-powered.com/mcp/homebase-mcp-by-usefulapi): Homebase MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Workyard MCP by usefulapi](https://ai-powered.com/mcp/workyard-mcp-by-usefulapi): Workyard MCP by usefulapi is a freemium MCP server for hr and payroll.
- [TalentHR MCP by usefulapi](https://ai-powered.com/mcp/talenthr-mcp-by-usefulapi): TalentHR MCP by usefulapi is a freemium MCP server for hiring and recruiting.
- [SmartHR MCP by usefulapi](https://ai-powered.com/mcp/smarthr-mcp-by-usefulapi): SmartHR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [HolidayPitches MCP by usefulapi](https://ai-powered.com/mcp/holidaypitches-mcp-by-usefulapi): HolidayPitches MCP by usefulapi is a freemium MCP server for travel booking.
- [Protime MCP by usefulapi](https://ai-powered.com/mcp/protime-mcp-by-usefulapi): Protime MCP by usefulapi is a freemium MCP server for human-in-the-loop tasks.

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