Timesheets.com MCP by usefulapi

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

Read users, clock status, items and reports, and create users or assign items in Timesheets.com.

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

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

概覽

AI 產生的概覽

託管式 Timesheets.com 連接器,讓助理讀取使用者、打卡狀態、項目與工時/薪資報表,並可建立使用者或指派項目。

可以做什麼
  • 列出並檢視使用者,包含薪資與工時追蹤設定
  • 建立使用者,並為使用者指派或移除客戶、專案與會計代碼
  • 列出並檢視客戶、專案、會計代碼、供應商與事件;建立與更新供應商和事件
  • 查看單一使用者或主管所轄團隊的打卡狀態與執行中的專案計時器
  • 取得依小時、專案與費用報表,薪資週期與薪資預覽,以及紀錄修訂歷程
  • 取得公司參考資料,例如狀態列舉值與時區 ID
適用情境
適合讓助理回答誰已打卡、工時依客戶或專案如何分配、某個薪資週期狀況如何等問題,也適合執行新增使用者、指派專案等小型管理操作。
執行需求
遠端 MCP 端點,無需本機安裝。透過 OAuth 登入,首次連線時需提供由主要管理員建立的 Timesheets.com API 金鑰與授權權杖;金鑰不會寫入用戶端設定。免費方案每月 50 次工具呼叫,付費方案可提高上限。
安裝前請注意
多個工具會寫入資料:建立使用者、指派或移除項目、建立或更新供應商與事件。當 send_notification_email 為 true 時,建立使用者會寄送邀請郵件。伺服器會依使用者儲存你的 Timesheets.com API 金鑰與授權權杖。付費方案透過付款連結結帳,取消後當期不退費。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

README

Timesheets.com MCP by usefulapi

Use your Timesheets.com account from Claude, Cursor, or any MCP client. Read users, clock status, items, project timers and reports, and create users or assign items to users. Hosted, no local install: connect with your own credentials.

Live endpoint: https://timesheets-com.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://timesheets-com.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http timesheets-com https://timesheets-com.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": {    "timesheets-com": {      "url": "https://timesheets-com.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 Timesheets.com credentials.

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

On first connect you provide the Timesheets.com API key and the authorization token (a Primary Administrator creates both in the API dashboard). The server validates them and stores them per user. No keys go in config files.

Tools

ToolTypeWhat it does
timesheets_list_usersreadList users
timesheets_get_user_inforeadGet user info
timesheets_create_userwriteCreate a user
timesheets_assign_user_itemswriteAssign items to a user
timesheets_unassign_user_itemswriteRemove items from a user
timesheets_list_itemsreadList items
timesheets_get_itemreadGet an item
timesheets_create_vendorwriteCreate a vendor
timesheets_update_vendorwriteUpdate a vendor
timesheets_create_eventwriteCreate an event
timesheets_update_eventwriteUpdate an event
timesheets_get_clock_shiftreadGet a user's clock shift
timesheets_list_clock_shiftsreadList clock shifts
timesheets_list_project_timersreadList project timers
timesheets_get_record_historyreadGet record history
timesheets_get_hourly_reportreadGet an hourly time report
timesheets_list_payroll_periodsreadList hourly payroll periods
timesheets_get_payroll_periodreadGet one hourly payroll period
timesheets_preview_payrollreadPreview an hourly payroll run
timesheets_get_project_reportreadGet a project time report
timesheets_get_expense_reportreadGet an expense report
timesheets_get_server_referencereadGet server reference data
timesheets_usage_statusmetaUsage status (free-tier meter)
timesheets_request_featuremetaRequest a missing feature
timesheets_upgrademetaUpgrade to Pro or Pro+
timesheets_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 timesheets_upgrade (it returns a Stripe Checkout link). Cancel any time with timesheets_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running timesheets_upgrade before then undoes the cancel. Or write to [email protected].

License

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

來源:servers/timesheets-com/README.md,提交 4046075

工具

22

timesheets_list_users

List users

List users of the company, with UserID, name, email, access level and status. Filter by user ids and status. Timesheets API: GET /users.

輸入參數statusmax_rowsuser_idsstart_row

timesheets_get_user_info

Get user info

Get report details for users: name, pay and tracking settings, supervisor. Empty user_ids returns all users. Timesheets API: GET /report/user/info.

輸入參數user_ids

timesheets_create_user

Create a user

Create a user in the company. Sends an invitation email only when send_notification_email is true (default false). Timesheets API: POST /user.

輸入參數email必填pay_type必填job_titlelast_name必填first_name必填dst_enabledtimezone_id必填access_level必填employee_typesupervisor_idenable_expense_reportsenable_hourly_tracking另有 2 個

timesheets_assign_user_items

Assign items to a user

Add customers, projects or account codes to a user. Existing assignments stay. Set defaults with default_id (customer, project) or the default_*_id fields (accountcode). Timesheets API: POST /user/{UserID}/customers|projects|accountcodes.

輸入參數kind必填user_id必填item_ids必填default_iddefault_hourly_iddefault_expense_iddefault_project_id

timesheets_unassign_user_items

Remove items from a user

Remove customers, projects or account codes from a user. Only the listed ids are removed. Removing a default resets it to the company default. Timesheets API: DELETE /user/{UserID}/customers|projects|accountcodes.

輸入參數kind必填user_id必填item_ids必填

timesheets_list_items

List items

List customers, projects, account codes, vendors or events. Filter by status, text and ids. Timesheets API: GET /items/{kind}.

輸入參數kind必填statusmax_rowsorder_bystart_rowexclude_idsinclude_idsfull_text_search

timesheets_get_item

Get an item

Get one customer, project, account code, vendor or event by id. Timesheets API: GET /item/{kind}/{id}.

輸入參數kind必填item_id必填

timesheets_create_vendor

Create a vendor

Create a vendor (used on expense records). Timesheets API: POST /item/vendor/0.

輸入參數citystatecommentsvendor_name必填contact_email

timesheets_update_vendor

Update a vendor

Change fields of one vendor. Only the given fields change. Timesheets API: PATCH /item/vendor/{id}.

輸入參數citystatecommentsvendor_id必填vendor_namecontact_email

timesheets_create_event

Create an event

Create an event (an expense or activity tag). Timesheets API: POST /item/event/0.

輸入參數event_name必填event_description

timesheets_update_event

Update an event

Change the name or description of one event. Timesheets API: PATCH /item/event/{id}.

輸入參數event_id必填event_nameevent_description

timesheets_get_clock_shift

Get a user's clock shift

Get a user's current clock status: clock-in and break times, location, hours for the shift and for today. Needs admin access to that user. Timesheets API: GET /clock/shift/user/{UserID} (key only).

輸入參數user_id必填

timesheets_list_clock_shifts

List clock shifts

List clock status for several users, or for the users one supervisor manages. Timesheets API: GET /clock/shift/users (key only).

輸入參數user_idssupervisor_id

timesheets_list_project_timers

List project timers

List a user's running project timers, optionally by customer, project or account code. Timesheets API: GET /project/timers/{UserID}.

輸入參數user_id必填project_idscustomer_idsaccount_code_ids

timesheets_get_record_history

Get record history

Get the revision history of one hourly, project or expense record. Needs admin access to the record's employee. Timesheets API: GET /record/{kind}/history/{RecordID}.

輸入參數kind必填record_id必填

timesheets_get_hourly_report

Get an hourly time report

Get an hourly time report for a date range, grouped and summarised or detailed. Processed = approved and finished records; unprocessed = the rest. Timesheets API: POST /report/hourly/customizable/{processed|unprocessed}.

輸入參數mode必填end_date必填user_idsall_usersgroup_typestart_date必填report_typeaccount_code_idsall_account_codesinclude_extended_datainclude_work_description

timesheets_list_payroll_periods

List hourly payroll periods

List hourly payroll periods that start and end in a date range. Timesheets API: GET /report/hourly/payroll/periods.

輸入參數end_date必填max_rowsstart_date必填

timesheets_get_payroll_period

Get one hourly payroll period

Get the hourly payroll report of one period, optionally for some users. Timesheets API: GET /report/hourly/payroll/period/{PayrollID}.

輸入參數user_idspayroll_id必填

timesheets_preview_payroll

Preview an hourly payroll run

Preview the hourly payroll for a date range and users. It is a preview: the call does not close a payroll period. Timesheets API: POST /report/hourly/payroll/preview.

輸入參數end_date必填run_typeuser_idsstart_date必填user_select

timesheets_get_project_report

Get a project time report

Get a project time report for a date range, by user, customer, project or account code. Timesheets API: POST /report/project/customizable.

輸入參數end_date必填user_idsall_usersgroup_typestart_date必填project_idsreport_typeall_projectscustomer_idsall_customersaccount_code_idsall_account_codes

timesheets_get_expense_report

Get an expense report

Get an expense report for a date range, by user, vendor, event, customer, project or account code. Timesheets API: POST /report/expense/customizable.

輸入參數end_date必填user_idsall_usersevent_idsall_eventsstart_date必填vendor_idsall_vendorsproject_idsreport_typeall_projectscustomer_ids另有 3 個

timesheets_get_server_reference

Get server reference data

Get the company's enum constants (user statuses, access types, record statuses) or the timezone ids used by timesheets_create_user. Timesheets API: GET /server/constants or /server/timezones.

輸入參數what必填

版本歷史

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 整合