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
- 01查看工作、客户和任务
- 02读取工时、请假及报表
- 03创建和修改工时记录
- 04提交或撤回工时表
Use cases
- 01查询项目和工时记录
- 02分析公司工时报告
- 03记录或修正已用工时
- 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.
https://clicktime.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-clicktime https://clicktime.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-clicktime":{"type":"http","url":"https://clicktime.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-clicktime":{"type":"http","url":"https://clicktime.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-clicktime":{"type":"http","url":"https://clicktime.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-clicktime":{"serverUrl":"https://clicktime.usefulapi.io/mcp"}}}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 READMEClickTime 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/mcpto 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
| Tool | Type | What it does |
|---|---|---|
clicktime_get_me | read | Get my user |
clicktime_get_company | read | Get company settings |
clicktime_list_jobs | read | List jobs (projects) |
clicktime_get_job | read | Get job |
clicktime_list_clients | read | List clients |
clicktime_list_tasks | read | List tasks |
clicktime_list_job_task_controls | read | List valid job and task pairs |
clicktime_list_job_phases | read | List job phases |
clicktime_list_time_entries | read | List my time entries |
clicktime_get_time_entry | read | Get time entry |
clicktime_list_timesheets | read | List my timesheets |
clicktime_get_timesheet_by_date | read | Get timesheet covering a date |
clicktime_list_timesheet_actions | read | List actions available on my timesheet |
clicktime_list_time_off_types | read | List time off types and balances |
clicktime_list_time_off | read | List my time off |
clicktime_list_time_off_requests | read | List my time off requests |
clicktime_list_expense_sheets | read | List my expense sheets |
clicktime_list_expense_items | read | List my expense items |
clicktime_list_users | read | List users |
clicktime_time_report | read | Time report (company-wide) |
clicktime_time_summary | read | Time summary (grouped) |
clicktime_create_time_entry | write | Log time |
clicktime_update_time_entry | write | Update time entry |
clicktime_submit_timesheet | write | Submit or recall my timesheet |
clicktime_create_client | write | Create client |
clicktime_create_job | write | Create job |
clicktime_usage_status | meta | Usage status (free-tier meter) |
clicktime_request_feature | meta | Request a missing feature |
clicktime_upgrade | meta | Upgrade to Pro (unlimited*) |
clicktime_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
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 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
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.