Skip to content
MCP server

Timebutler MCP by usefulapi

Read absences, time entries and balances; run the time clock and request absences in…

Install
Runs
Remotely
Version
1.7.0
Listing updated
5 days ago

About Timebutler MCP by usefulapi

Timebutler MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read absences, time entries and balances; run the time clock and request absences in Timebutler.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "timebutler": {
      "url": "https://timebutler.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": {
    "timebutler": {
      "type": "http",
      "url": "https://timebutler.usefulapi.io/mcp"
    }
  }
}

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

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

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

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

Tools this server provides (20)

Read directly from the server.

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.

Timebutler MCP by usefulapi FAQ

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