Timebutler MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableProductivity & Workflow Business & Commerce

Server details

Identifier: io.usefulapi/timebutler
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Nov 1, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified that this server's namespace belongs to usefulapi.io, which also runs its endpoint. That identifies the publisher; it does not make the server's tools safe.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.usefulapi%2Ftimebutler.svg)](https://sourceweft.com/mcp/io.usefulapi%2Ftimebutler?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Hosted Timebutler connector that lets an assistant read absences, time entries and balances, run the time clock, and submit absence requests.

What you can do: Read profile, employees, absence types, categories and projects
List own and team absence requests, pending counts, and submit absence requests
List own time entries, team time entry requests and pending counts
Check time clock status, today's work summary and time-off balances
Start, pause, resume and stop the time clock, or submit a finished time entry
Check usage, request a feature, upgrade or cancel the subscription
When to use it: Useful when you want an assistant to answer questions about your Timebutler hours, vacation balance or who on the team is away, or to start and stop your time clock and file absence requests without opening Timebutler.
Requirements: Remote MCP endpoint, no local install. Sign-in uses OAuth; on first connect you supply a Timebutler personal access token created in your Timebutler account settings. No API key or Authorization header goes in the client config. A Timebutler account is required.

Before you install

Write tools change Timebutler data: they start, pause, resume and stop the clock, save time entries and submit absence requests, so confirm before running them. The server stores your Timebutler personal access token per user. Usage is metered: the free plan allows 50 tool calls a month, and paid plans are billed through Stripe checkout links; cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

Open Timebutler MCP by usefulapi in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Ftimebutler/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Timebutler MCP by usefulapi

Use your Timebutler account from Claude, Cursor, or any MCP client. It reads absences, time entries, time-off balances and, for managers, team requests, and it can run the time clock and request absences. Hosted, no local install: connect with your own credentials.

Live endpoint: https://timebutler.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://timebutler.usefulapi.io/mcp.
Claude Code: claude mcp add --transport http timebutler https://timebutler.usefulapi.io/mcp, then run /mcp to log in.
VS Code: Add to VS Code.
Cursor and other clients: add the URL as a remote MCP server:

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Timebutler credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/timebutler/

On first connect you provide a Timebutler personal access token (it starts with tb_; create it in your Timebutler account settings under personal access tokens). The server validates it and stores it per user. No keys go in config files.

Tools

Tool	Type	What it does
`timebutler_get_profile`	read	Get my profile
`timebutler_list_employees`	read	List employees
`timebutler_list_absence_types`	read	List absence types
`timebutler_list_categories`	read	List time categories
`timebutler_list_projects`	read	List projects
`timebutler_list_my_absence_requests`	read	List my absence requests
`timebutler_list_team_absence_requests`	read	List team absence requests
`timebutler_get_absence_pending_count`	read	Count pending absence requests
`timebutler_list_my_time_entries`	read	List my time entries
`timebutler_get_time_entry_pending_count`	read	Count pending time entries
`timebutler_list_time_entry_requests`	read	List time entry requests
`timebutler_get_time_clock_status`	read	Get time clock status
`timebutler_get_work_summary`	read	Get today's work summary
`timebutler_get_time_off_summary`	read	Get time-off summary
`timebutler_clock_start`	write	Start time clock
`timebutler_clock_pause`	write	Pause time clock
`timebutler_clock_resume`	write	Resume time clock
`timebutler_clock_stop`	write	Stop time clock and save
`timebutler_submit_clock_entry`	write	Submit a finished time entry
`timebutler_create_absence_request`	write	Request absence
`timebutler_usage_status`	meta	Usage status (free-tier meter)
`timebutler_request_feature`	meta	Request a missing feature
`timebutler_upgrade`	meta	Upgrade to Pro or Pro+
`timebutler_cancel_subscription`	meta	Cancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with timebutler_upgrade (it returns a Stripe Checkout link). Cancel any time with timebutler_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running timebutler_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/timebutler/README.md at commit 4046075

Tools

timebutler_get_profile

Get my 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.

Takes no parameters.

timebutler_list_employees

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.

Takes no parameters.

timebutler_list_absence_types

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.

Takes no parameters.

timebutler_list_projects

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.

Takes no parameters.

timebutler_list_my_absence_requests

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.

Takes no parameters.

timebutler_list_team_absence_requests

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.

Takes no parameters.

timebutler_get_absence_pending_count

Count pending 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.

Takes no parameters.

timebutler_list_my_time_entries

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.

ParametersyearmonthstatusprojectIdcategoryId

timebutler_get_time_entry_pending_count

Count pending time entries

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

Takes no parameters.

timebutler_list_time_entry_requests

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.

Takes no parameters.

timebutler_get_time_clock_status

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.

Takes no parameters.

timebutler_get_work_summary

Get today's 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.

Takes no parameters.

timebutler_get_time_off_summary

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.

Takes no parameters.

timebutler_clock_start

Start time clock

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.

Takes no parameters.

timebutler_clock_pause

Pause time clock

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

Takes no parameters.

timebutler_clock_resume

Resume time clock

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

Takes no parameters.

timebutler_clock_stop

Stop time clock and save

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.

ParametersremarksprojectIdcategoryIdbreakRegulation

timebutler_submit_clock_entry

Submit a finished time 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.

ParametersremarksprojectIdcategoryIdendTimestamprequiredpauseSecondsstartTimestamprequired

timebutler_create_absence_request

Request absence

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.

ParametershoursendDaterequiredhalfDaycommentsstartDaterequiredabsenceTypeIdrequiredsubstituteEmployeeId

Version history

v1.3.4LatestNov 7, 2026
v1.2.3Nov 5, 2026
v1.2.2Nov 5, 2026
v1.2.1Nov 4, 2026
v1.2.0Nov 3, 2026
v1.1.1Nov 3, 2026
v1.0.0Nov 1, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts