Timebutler MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.3.4更新於 Nov 7, 2026

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

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行效率與工作流商業與電商

概覽

AI 產生的概覽

託管的 Timebutler 連接器,讓助理讀取請假、工時紀錄與餘額,操作打卡時鐘並提交請假申請。

可以做什麼
  • 讀取個人資料、員工、請假類型、工時分類與專案
  • 查看本人及團隊的請假申請、待處理數量,並提交請假申請
  • 查看本人工時紀錄、團隊工時申請與待核准數量
  • 查詢打卡狀態、當日工時摘要與休假餘額
  • 開始、暫停、繼續、停止打卡,或提交已完成的工時紀錄
  • 查看用量、提出功能需求、升級或取消訂閱
適用情境
適合讓助理回答關於你的工時、特休餘額或團隊誰在請假的問題,也適合在不開啟 Timebutler 的情況下開始與停止打卡、提交請假申請。
執行需求
遠端 MCP 端點,無需本機安裝。透過 OAuth 登入,首次連線時需提供在 Timebutler 帳戶設定中建立的個人存取權杖。用戶端設定不需要 API 金鑰或 Authorization 標頭。需要 Timebutler 帳戶。
安裝前請注意
寫入類工具會變更 Timebutler 資料:開始、暫停、繼續與停止打卡,儲存工時紀錄並提交請假申請,執行前應先確認。伺服器會依使用者儲存你的 Timebutler 個人存取權杖。用量按次計費:免費方案每月 50 次工具呼叫,付費方案透過 Stripe 結帳連結付款;取消後服務持續到已付費期間結束,當期不退款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Timebutler MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Ftimebutler/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

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

ToolTypeWhat it does
timebutler_get_profilereadGet my profile
timebutler_list_employeesreadList employees
timebutler_list_absence_typesreadList absence types
timebutler_list_categoriesreadList time categories
timebutler_list_projectsreadList projects
timebutler_list_my_absence_requestsreadList my absence requests
timebutler_list_team_absence_requestsreadList team absence requests
timebutler_get_absence_pending_countreadCount pending absence requests
timebutler_list_my_time_entriesreadList my time entries
timebutler_get_time_entry_pending_countreadCount pending time entries
timebutler_list_time_entry_requestsreadList time entry requests
timebutler_get_time_clock_statusreadGet time clock status
timebutler_get_work_summaryreadGet today's work summary
timebutler_get_time_off_summaryreadGet time-off summary
timebutler_clock_startwriteStart time clock
timebutler_clock_pausewritePause time clock
timebutler_clock_resumewriteResume time clock
timebutler_clock_stopwriteStop time clock and save
timebutler_submit_clock_entrywriteSubmit a finished time entry
timebutler_create_absence_requestwriteRequest absence
timebutler_usage_statusmetaUsage status (free-tier meter)
timebutler_request_featuremetaRequest a missing feature
timebutler_upgrademetaUpgrade to Pro or Pro+
timebutler_cancel_subscriptionmetaCancel 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

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*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.

來源:servers/timebutler/README.md,提交 4046075

工具

20

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

timebutler_list_categories

List time 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 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 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 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 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.

無需輸入參數。

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.

輸入參數yearmonthstatusprojectIdcategoryId

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

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.

無需輸入參數。

timebutler_clock_pause

Pause time clock

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

無需輸入參數。

timebutler_clock_resume

Resume time clock

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

無需輸入參數。

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.

輸入參數remarksprojectIdcategoryIdbreakRegulation

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.

輸入參數remarksprojectIdcategoryIdendTimestamp必填pauseSecondsstartTimestamp必填

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.

輸入參數hoursendDate必填halfDaycommentsstartDate必填absenceTypeId必填substituteEmployeeId

版本歷史

7
  1. v1.3.4最新Nov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026
  7. v1.0.0Nov 1, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合