Timebutler MCP by usefulapi

Pause the running time clock of the caller (starts a break). Timebutler API: POST /time-clock/pause.

Resume the paused time clock of the caller (ends the break). Timebutler API: POST /time-clock/resume.

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.

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.

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.

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.

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.

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.

Count the time entries of the caller's team that wait for approval (manager or admin only). Timebutler API: GET /time-entries/pending-count.

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.

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.

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.

List the time-tracking categories and the default category id. Use an id in the clock and time-entry tools. Timebutler API: GET /categories.

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.

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.

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.

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.

List absence requests of the employees the caller manages (manager or admin only). Shows status and employee names. Timebutler API: GET /absence-requests/team.

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.

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.