mcpField
C
ClickTime MCP by usefulapi

ClickTime MCP by usefulapi

Remote
usefulapi.ioProductivity1Updated today

About ClickTime MCP by usefulapi

ClickTime MCP by usefulapi is a hosted MCP server for ClickTime users and their MCP clients. It provides read access to jobs, time records, time off and reports, alongside tools to record time and submit timesheets.

Key features

  1. 01查看工作、客户和任务
  2. 02读取工时、请假及报表
  3. 03创建和修改工时记录
  4. 04提交或撤回工时表

Use cases

  1. 01查询项目和工时记录
  2. 02分析公司工时报告
  3. 03记录或修正已用工时
  4. 04提交或撤回工时表

MCP support

作为托管 MCP 服务,向 Claude、Cursor 等 MCP 客户端提供 ClickTime 数据查询和写入工具。通过 OAuth 登录并验证 ClickTime API token。

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://clicktime.usefulapi.io/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

ClickTime MCP by usefulapi

Use your ClickTime account from Claude, Cursor, or any MCP client. Read jobs, timesheets, time off and company reports, and log, edit or submit your own time. Hosted, no local install: connect with your own credentials.

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

Connect

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

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

On first connect you provide your ClickTime API token, found in ClickTime under My Preferences, then the Authentication Token tab. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
clicktime_get_mereadGet my user
clicktime_get_companyreadGet company settings
clicktime_list_jobsreadList jobs (projects)
clicktime_get_jobreadGet job
clicktime_list_clientsreadList clients
clicktime_list_tasksreadList tasks
clicktime_list_job_task_controlsreadList valid job and task pairs
clicktime_list_job_phasesreadList job phases
clicktime_list_time_entriesreadList my time entries
clicktime_get_time_entryreadGet time entry
clicktime_list_timesheetsreadList my timesheets
clicktime_get_timesheet_by_datereadGet timesheet covering a date
clicktime_list_timesheet_actionsreadList actions available on my timesheet
clicktime_list_time_off_typesreadList time off types and balances
clicktime_list_time_offreadList my time off
clicktime_list_time_off_requestsreadList my time off requests
clicktime_list_expense_sheetsreadList my expense sheets
clicktime_list_expense_itemsreadList my expense items
clicktime_list_usersreadList users
clicktime_time_reportreadTime report (company-wide)
clicktime_time_summaryreadTime summary (grouped)
clicktime_create_time_entrywriteLog time
clicktime_update_time_entrywriteUpdate time entry
clicktime_submit_timesheetwriteSubmit or recall my timesheet
clicktime_create_clientwriteCreate client
clicktime_create_jobwriteCreate job
clicktime_usage_statusmetaUsage status (free-tier meter)
clicktime_request_featuremetaRequest a missing feature
clicktime_upgrademetaUpgrade to Pro (unlimited*)
clicktime_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 clicktime_upgrade (it returns a Stripe Checkout link). Cancel any time with clicktime_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running clicktime_upgrade before then undoes the cancel. Or write to [email protected].

License

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.