# TimeTrex MCP by usefulapi

> TimeTrex MCP by usefulapi is a freemium MCP server for time tracking. Read-only hosted MCP server exposing TimeTrex employees, punches, branches and departments. 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:** API, Web, vscode
- **Website:** https://usefulapi.io/timetrex/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timetrex
- **MCP Registry name:** io.usefulapi/timetrex
- **Categories:** time tracking
- **Listing updated:** 2026-11-18

## About

The README describes this as a hosted connector that lets an AI client read data from a TimeTrex installation without any local setup. Four read-only tools cover employee lookup by number or name, clock in and clock out punches over a date range, the company's branches and its departments. Record ids returned by the employee tool can be passed into the punch tool.

Access runs through the owner's own TimeTrex web address and registered API key, entered once during an OAuth-style login in the client. The server calls the TimeTrex API on the user's behalf, so it only sees what that account can see. Usefulapi states it is an independent service, not affiliated with TimeTrex.

The tool suits HR and payroll staff who want to check punches for a pay period or review how a company's sites and departments are set up, directly from Claude, ChatGPT, Cursor or VS Code.

## Features

- **Employee lookup:** Lists employees with record id, employee number and name, filterable by number or name.
- **Time punch history:** Returns clock in and clock out records for one employee between two yyyy-mm-dd dates.
- **Branch listing:** Lists the branches of the TimeTrex installation, which the listing describes as work sites.
- **Department listing:** Lists the departments of the TimeTrex installation.
- **Hosted remote endpoint:** Runs on usefulapi's servers over Streamable HTTP, so no local install is needed.
- **Usage and plan tools:** Includes tools to check usage against the monthly cap, request a missing feature, upgrade or cancel a subscription.

## Good for

- Find an employee's record id from their name or employee number
- Pull one employee's clock in and clock out records for a pay period
- Review which branches and departments exist in a TimeTrex installation
- Ask an AI assistant plain-language questions about attendance records

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `timetrex_list_employees`: List employees in the TimeTrex installation: record id, employee number, first and last name. Filter by employee number or name.
- `timetrex_list_punches`: List time punches (clock in and clock out records) for one employee between two dates.
- `timetrex_list_branches`: List branches (work sites) of the TimeTrex installation.
- `timetrex_list_departments`: List departments of the TimeTrex installation.

## FAQ

### What can I do with TimeTrex in Claude or ChatGPT?

The README and site list four read tools: listing employees, listing punches for one employee between two dates, listing branches and listing departments.

### Can the AI change my TimeTrex data?

No. The site states that all four TimeTrex tools are marked read-only.

### Is this an official TimeTrex product?

No. The site says usefulapi is an independent service and is not affiliated with or endorsed by TimeTrex.

### What does it cost?

The site lists a Free plan with 50 tool calls a month, Pro at $9 per month or $90 per year with 10,000 calls, and Pro+ at $39 per month or $390 per year with 100,000 calls. Each paid plan covers this server only.

### Is TimeTrex MCP by usefulapi free?

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

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

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

The closest alternatives to TimeTrex MCP by usefulapi are TotemClock MCP by usefulapi, TimeStation MCP by usefulapi, ROLLER MCP by usefulapi, Staffwise MCP by usefulapi and Paydirt 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

- [TotemClock MCP by usefulapi](https://ai-powered.com/mcp/totemclock-mcp-by-usefulapi): TotemClock MCP by usefulapi is a freemium MCP server for hiring and recruiting.
- [TimeStation MCP by usefulapi](https://ai-powered.com/mcp/timestation-mcp-by-usefulapi): TimeStation MCP by usefulapi is a freemium MCP server for hr and payroll.
- [ROLLER MCP by usefulapi](https://ai-powered.com/mcp/roller-mcp-by-usefulapi): ROLLER MCP by usefulapi is a freemium MCP server for time tracking.
- [Staffwise MCP by usefulapi](https://ai-powered.com/mcp/staffwise-mcp-by-usefulapi): Staffwise MCP by usefulapi is a freemium MCP server for time tracking.
- [Paydirt MCP by usefulapi](https://ai-powered.com/mcp/paydirt-mcp-by-usefulapi): Paydirt MCP by usefulapi is a freemium MCP server for time tracking.
- [Bookafy MCP by usefulapi](https://ai-powered.com/mcp/bookafy-mcp-by-usefulapi): Bookafy MCP by usefulapi is a freemium MCP server for time tracking.
- [Zaui MCP by usefulapi](https://ai-powered.com/mcp/zaui-mcp-by-usefulapi): Zaui MCP by usefulapi is a freemium MCP server for time tracking.
- [Timicx MCP by usefulapi](https://ai-powered.com/mcp/timicx-mcp-by-usefulapi): Timicx MCP by usefulapi is a freemium MCP server for time tracking.

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