# Timebutler MCP by usefulapi

> Timebutler MCP by usefulapi is a freemium MCP server for hr and payroll. Hosted MCP server connecting Timebutler absences, time tracking and balances to 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:** API, Web, vscode, CLI
- **Website:** https://usefulapi.io/timebutler/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/timebutler
- **MCP Registry name:** io.usefulapi/timebutler
- **Categories:** [hr and payroll](https://ai-powered.com/categories/hr-and-payroll)
- **Listing updated:** 2026-11-18

## About

The server gives an AI assistant access to a Timebutler account through a remote endpoint, so there is nothing to install locally. Once connected, it can look up vacation and sickness balances, list absence requests, read time entries and today's work summary, and control the time clock. Write actions cover starting, pausing, resuming and stopping the clock, saving a finished time entry, and submitting an absence request.

Access runs under the signed-in user's own Timebutler token, so the AI sees only what that account can see. Managers and admins also get tools for team absence requests, pending counts and employee lists. The README notes that the server does not approve or reject requests.

The product suits employees who log time and request leave in Timebutler and want to do it from Claude, ChatGPT, Cursor, VS Code or another MCP-compatible client. It is an independent service from usefulapi and is not affiliated with Timebutler.

## Features

- **Hosted remote endpoint:** Connects over Streamable HTTP with OAuth login, so no local install or API key in client config is needed.
- **Balance and absence lookup:** Shows vacation and sickness balances along with the caller's own absence requests and their status.
- **Time clock control:** Starts, pauses, resumes and stops the Timebutler time clock and reads its current state.
- **Manual time entries:** Submits a finished time entry with start and end times on the same day, tied to a project and category.
- **Team request overview:** For managers and admins, lists team absence and time entry requests and counts pending items.
- **Usage metering:** Reports calls used against the plan limit and offers an upgrade path through the AI client.

## Good for

- Checking how many vacation days remain before planning a trip
- Requesting leave from inside a chat assistant
- Starting and stopping the time clock while working on a project
- Logging a finished block of work as a time entry at the end of the day
- Letting a manager see who is off next week and which requests are pending

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `timebutler_get_profile`: Get the profile of the user behind the token: id, name, email, role (USER, MANAGER or ADMIN), department, branch office, and whether business trips and time tracking are enabled. Timebutler API: GET /user/profile.
- `timebutler_list_employees`: List the employees the caller can see (manager or admin only), with ids, names, role, department, manager ids and active flag. Use the ids in other tools. Timebutler API: GET /employees.
- `timebutler_list_absence_types`: List the absence types the company configured (vacation, sickness and others), with whether each needs approval, a medical certificate, or allows half days. Use the id in timebutler_create_absence_request. Timebutler API: GET /absence-types.
- `timebutler_list_categories`: List the time-tracking categories and the default category id. Use an id in the clock and time-entry tools. Timebutler API: GET /categories.
- `timebutler_list_projects`: List the time-tracking projects, the default project id, and whether a project is mandatory. Use an id in the clock and time-entry tools. Timebutler API: GET /projects.
- `timebutler_list_my_absence_requests`: List the caller's own absence requests with dates, days or hours, half-day setting, and status (pending, approved or rejected). Timebutler API: GET /absence-requests/my.
- `timebutler_list_team_absence_requests`: List absence requests of the employees the caller manages (manager or admin only). Shows status and employee names. Timebutler API: GET /absence-requests/team.
- `timebutler_get_absence_pending_count`: Count the open absence requests and open cancellation requests for the caller's team (manager or admin only). Timebutler API: GET /absence-requests/pending-count.
- `timebutler_list_my_time_entries`: List the caller's recorded time entries, sorted by date and start time. Without year and month it returns the current month; year alone returns a whole year. Optional filters: project, category and status. Timebutler API: GET /time-entries/my.
- `timebutler_get_time_entry_pending_count`: Count the time entries of the caller's team that wait for approval (manager or admin only). Timebutler API: GET /time-entries/pending-count.
- `timebutler_list_time_entry_requests`: List the pending time entry requests of the caller's team with date, start and end time, worked minutes, project and remarks (manager or admin only). Timebutler API: GET /time-entry-requests.
- `timebutler_get_time_clock_status`: Get the caller's time clock state: idle, running, paused or waiting, with the start time, elapsed work seconds and break seconds. Timebutler API: GET /time-clock/status.
- `timebutler_get_work_summary`: Get today's working-time summary for the caller: commitment, worked, remaining minutes, percent done and break minutes. Timebutler API: GET /time-tracking/work-summary.
- `timebutler_get_time_off_summary`: Get the caller's vacation and sickness balance: vacation days total, remaining, approved and pending, and illness days taken. Timebutler API: GET /time-tracking/time-off-summary.
- `timebutler_clock_start`: Start the caller's time clock. Fails with HTTP 409 when the clock already runs. The clock can enter the waiting state first if the company sets a minimum start interval. Timebutler API: POST /time-clock/start.
- `timebutler_clock_pause`: Pause the running time clock of the caller (starts a break). Timebutler API: POST /time-clock/pause.
- `timebutler_clock_resume`: Resume the paused time clock of the caller (ends the break). Timebutler API: POST /time-clock/resume.
- `timebutler_clock_stop`: Stop the running or paused time clock and save the resulting time entry. Optional project id, category id and remarks. A waiting clock is discarded (HTTP 204). Timebutler API: POST /time-clock/stop.
- `timebutler_submit_clock_entry`: Create a finished time entry from a start and end time on the same calendar day. Timestamps are Unix milliseconds. If the company needs manager approval, the entry starts as pending. Timebutler API: POST /time-tracking/clock-entry.
- `timebutler_create_absence_request`: Submit an absence or vacation request for the caller. The status is pending when the absence type needs manager approval, otherwise approved. Timebutler API: POST /absence-requests.

## FAQ

### Is this an official Timebutler product?

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

### Can the AI change my Timebutler data?

Yes, if you approve it. Six of the 24 tools can create or change data, and the rest are read-only. Most MCP clients ask for approval before a tool call runs.

### What does it cost?

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

### What do I need to connect?

A Timebutler personal access token, which you create in your Timebutler account settings. The login page asks for it, and the server does not ask for your password.

### Is Timebutler MCP by usefulapi free?

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

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

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

The closest alternatives to Timebutler MCP by usefulapi are Rotawise Shift Scheduler, TopTimesheets Deskless Clock-In & Payroll ROI, CareLineLive MCP by usefulapi, ExpenseOnDemand MCP by usefulapi and Talexio MCP by usefulapi.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 14 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Rotawise Shift Scheduler](https://ai-powered.com/mcp/rotawise-shift-scheduler): Rotawise Shift Scheduler is an MCP server for hr and payroll.
- [TopTimesheets Deskless Clock-In & Payroll ROI](https://ai-powered.com/mcp/toptimesheets-deskless-clock-in-and-payroll-roi): TopTimesheets Deskless Clock-In & Payroll ROI is a freemium MCP server for communication.
- [CareLineLive MCP by usefulapi](https://ai-powered.com/mcp/carelinelive-mcp-by-usefulapi): CareLineLive MCP by usefulapi is a freemium MCP server for hr and payroll.
- [ExpenseOnDemand MCP by usefulapi](https://ai-powered.com/mcp/expenseondemand-mcp-by-usefulapi): ExpenseOnDemand MCP by usefulapi is a freemium MCP server for finance and payments.
- [Talexio MCP by usefulapi](https://ai-powered.com/mcp/talexio-mcp-by-usefulapi): Talexio MCP by usefulapi is a freemium MCP server for hr and payroll.
- [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.
- [Go2Clock MCP by usefulapi](https://ai-powered.com/mcp/go2clock-mcp-by-usefulapi): Go2Clock 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.

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