Clockify MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.24.3更新于 Nov 7, 2026

Track time in Clockify: time entries, projects, clients, tags and reports; start, stop and log time.

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行效率与工作流数据与分析商业与电商

概览

AI 生成的概览

托管版 Clockify 服务器,让助手读取、记录、修改并统计时间条目、计时器、项目、客户、任务和标签。

可以做什么
  • 读取账户、工作区、成员、客户、项目、任务和标签信息
  • 列出、查看并按条件筛选时间条目,查看当前正在运行的计时器
  • 按日期范围生成汇总总计和逐条明细报表
  • 记录工时、启动和停止计时器,修改或删除时间条目
  • 创建项目、任务、客户和标签
  • 查看当月用量、提交功能请求、升级或取消付费方案
适用场景
适合向助手询问已记录的工时,例如上周各项目的小时数或本月哪个客户耗时最多,也适合不打开 Clockify 就记录和调整时间。适用于个人计时和小团队报表,而非深度财务核算。
运行要求
远程 MCP 端点,无需本地安装。只需填写服务器地址,通过 OAuth 使用 Clockify 账号登录;不要在配置中添加 API 密钥或 Authorization 头。需要 Clockify 账号和工作区。免费版每月 50 次工具调用,付费方案可提高上限。
安装前请注意
写入类工具会改动 Clockify 数据:创建条目、项目、任务、客户和标签,修改条目,以及永久删除无法恢复的时间条目。更新会先读取再整体重写条目,并发编辑可能丢失。Clockify 登录经由托管服务商完成。付费方案需付费(Pro 每月 9 美元或每年 90 美元,Pro+ 每月 39 美元或每年 390 美元),通过 Stripe 结账链接付款;取消后当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Clockify MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fclockify/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

Clockify MCP by usefulapi

Use Clockify from Claude, Cursor, or any MCP client — time entries, timers, projects, clients, tasks, tags and summary or detailed reports. Hosted, no local install: connect with your own Clockify credentials.

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

Connect

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

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

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 Clockify credentials.

Tools

ToolTypeWhat it does
clockify_get_current_userreadGet current user
clockify_list_workspacesreadList workspaces
clockify_list_usersreadList workspace users
clockify_list_clientsreadList clients
clockify_list_projectsreadList projects
clockify_get_projectreadGet a project
clockify_list_tasksreadList project tasks
clockify_list_tagsreadList tags
clockify_list_time_entriesreadList time entries
clockify_get_time_entryreadGet a time entry
clockify_get_running_timerreadGet running timer
clockify_summary_reportreadSummary report
clockify_detailed_reportreadDetailed report
clockify_create_time_entrywriteLog time or start a timer
clockify_stop_timerwriteStop running timer
clockify_update_time_entrywriteUpdate a time entry
clockify_delete_time_entrywriteDelete a time entry
clockify_create_projectwriteCreate a project
clockify_create_taskwriteCreate a task
clockify_create_clientwriteCreate a client
clockify_create_tagwriteCreate a tag
clockify_usage_statusmetaUsage status (free-tier meter)
clockify_request_featuremetaRequest a missing feature
clockify_upgrademetaUpgrade to Pro or Pro+
clockify_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 clockify_upgrade (it returns a Stripe Checkout link). Cancel any time with clockify_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running clockify_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by Clockify.

来源:servers/clockify/README.md,提交 4046075

工具

21

clockify_get_current_user

Get current user

The Clockify user this API key belongs to: id, name, email, status, active and default workspace ids, and profile settings (time zone, week start, date/time format). GET /v1/user.

无需输入参数。

clockify_list_workspaces

List workspaces

List the Clockify workspaces you belong to: id, name, plan (featureSubscriptionType), subdomain, currencies and default hourly/cost rate. Use the id as workspace_id in other tools. GET /v1/workspaces.

输入参数roles

clockify_list_users

List workspace users

List the members of a workspace: id, name, email, status and settings. Filter by name, email, status or project access. GET /v1/workspaces/{workspaceId}/users.

输入参数namepageemailstatuspage_sizeproject_idworkspace_id

clockify_list_clients

List clients

List the clients of a workspace (id, name, email, address, currency, archived). GET /v1/workspaces/{workspaceId}/clients.

输入参数namepagearchivedpage_sizeworkspace_id

clockify_list_projects

List projects

List the projects of a workspace: id, name, client, billable, public, color, archived, duration tracked, estimate and rates. Filter by name, client, user, billable or archived. GET /v1/workspaces/{workspaceId}/projects.

输入参数namepagearchivedbillablehydrateduser_idspage_sizeclient_idsworkspace_id

clockify_get_project

Get a project

One project by id: name, client, billable, color, note, estimate, duration tracked, rates and memberships. GET /v1/workspaces/{workspaceId}/projects/{projectId}.

输入参数hydratedproject_id必填workspace_id

clockify_list_tasks

List project tasks

List the tasks of a project (id, name, status, assignees, estimate, duration tracked). GET /v1/workspaces/{workspaceId}/projects/{projectId}/tasks.

输入参数namepageis_activepage_sizeproject_id必填workspace_id

clockify_list_tags

List tags

List the tags of a workspace (id, name, archived). GET /v1/workspaces/{workspaceId}/tags.

输入参数namepagearchivedpage_sizeworkspace_id

clockify_list_time_entries

List time entries

List the time entries of one user (default: you), newest first: id, description, project, task, tags, billable and timeInterval (start, end, ISO 8601 duration). Filter by time range, project, task, tags or description. For totals across users use clockify_summary_report. GET /v1/workspaces/{workspaceId}/user/{userId}/time-entries.

输入参数endpagestarttag_idstask_iduser_idhydratedpage_sizeproject_iddescriptionworkspace_id

clockify_get_time_entry

Get a time entry

One time entry by id: description, project, task, tags, billable, rates, custom fields and timeInterval. GET /v1/workspaces/{workspaceId}/time-entries/{id}.

输入参数hydratedworkspace_idtime_entry_id必填

clockify_get_running_timer

Get running timer

The timer that is running right now for a user (default: you), or running: false. GET /v1/workspaces/{workspaceId}/user/{userId}/time-entries?in-progress=true.

输入参数user_idworkspace_id

clockify_summary_report

Summary report

Totals of tracked time (seconds) and amounts for a date range across the workspace, grouped by up to 3 levels (default project → time entry), e.g. hours per user per project last month. Respects the filters. POST reports /v1/workspaces/{workspaceId}/reports/summary.

输入参数to必填from必填tag_idsbillablegroup_byuser_idstime_zoneclient_idsdescriptionproject_idsworkspace_id

clockify_detailed_report

Detailed report

Every time entry in a date range across the workspace (user, project, client, task, tags, description, start/end, duration in seconds, amount), with totals; newest first, paged. POST reports /v1/workspaces/{workspaceId}/reports/detailed.

输入参数to必填from必填pagetag_idsbillableuser_idspage_sizetime_zoneclient_idsdescriptionproject_idsworkspace_id

clockify_create_time_entry

Log time or start a timer

WRITE: add a time entry for yourself. With end = a finished entry (log time); without end = a running timer that starts at start (default now). A workspace with required custom fields may refuse it. POST /v1/workspaces/{workspaceId}/time-entries.

输入参数endtypestarttag_idstask_idbillableproject_iddescriptionworkspace_id

clockify_stop_timer

Stop running timer

WRITE: stop the running timer of a user (default: you) at end (default now). Clockify answers 404 if no timer is running. PATCH /v1/workspaces/{workspaceId}/user/{userId}/time-entries.

输入参数enduser_idworkspace_id

clockify_update_time_entry

Update a time entry

WRITE: change a time entry's start, end, description, project, task, tags or billable. Only the fields you pass change: the entry is read first and every other field (custom fields included) is sent back as it was. The entry is rewritten (PUT) from a fresh read, so an edit made to the same entry in between (e.g. in the Clockify app) can be lost. A new project without task_id clears the task. GET then PUT /v1/workspaces/{workspaceId}/time-entries/{id}.

输入参数endstarttag_idstask_idbillableproject_iddescriptionworkspace_idtime_entry_id必填

clockify_delete_time_entry

Delete a time entry

WRITE (destructive): permanently delete one time entry. It cannot be undone. DELETE /v1/workspaces/{workspaceId}/time-entries/{id}.

输入参数workspace_idtime_entry_id必填

clockify_create_project

Create a project

WRITE: create a project in a workspace (needs an admin or project-manager role, depending on workspace settings). POST /v1/workspaces/{workspaceId}/projects.

输入参数name必填notecolorbillableclient_idis_publicworkspace_id

clockify_create_task

Create a task

WRITE: add a task to a project. POST /v1/workspaces/{workspaceId}/projects/{projectId}/tasks.

输入参数name必填estimateproject_id必填assignee_idsworkspace_id

clockify_create_client

Create a client

WRITE: add a client to a workspace. POST /v1/workspaces/{workspaceId}/clients.

输入参数name必填noteemailaddressworkspace_id

clockify_create_tag

Create a tag

WRITE: add a tag to a workspace. POST /v1/workspaces/{workspaceId}/tags.

输入参数name必填workspace_id

版本历史

19
  1. v1.24.3最新Nov 7, 2026
  2. v1.23.3Nov 5, 2026
  3. v1.23.2Nov 5, 2026
  4. v1.23.1Nov 4, 2026
  5. v1.23.0Nov 3, 2026
  6. v1.22.1Nov 3, 2026
  7. v1.21.0Nov 1, 2026
  8. v1.19.0Oct 31, 2026
  9. v1.18.0Oct 31, 2026
  10. v1.17.2Oct 30, 2026
  11. v1.17.0Oct 30, 2026
  12. v1.12.0Oct 26, 2026
  13. v1.9.3Oct 25, 2026
  14. v1.9.0Oct 25, 2026
  15. v1.8.0Oct 24, 2026
  16. v1.5.0Oct 23, 2026
  17. v1.4.4Oct 22, 2026
  18. v1.4.3Oct 21, 2026
  19. v1.0.0Oct 9, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成