MCP server
Timebutler MCP by usefulapi
Read absences, time entries and balances; run the time clock and request absences in…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://timebutler.usefulapi.io/mcpInstall 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