MCP server
DeskTime MCP by usefulapi
Read tracked time and projects; create projects and start or stop timers in DeskTime.
- Runs
- Remotely
- Version
- 1.6.0
- Listing updated
- 4 days ago
About DeskTime MCP by usefulapi
DeskTime MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http desktime https://desktime.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://desktime.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"desktime": {
"url": "https://desktime.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"desktime": {
"type": "http",
"url": "https://desktime.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"desktime": {
"serverUrl": "https://desktime.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"desktime": {
"type": "http",
"url": "https://desktime.usefulapi.io/mcp"
}
}
}Tools this server provides (10)
Read directly from the server.
- desktime_get_company
- The DeskTime company account this API key belongs to: company name, work schedule (start, end, duration, working days), tracking window and account timezone. GET /company.
- desktime_list_employees
- All employees of the company with their tracked time for a day, week or month: arrived/left, online, desk, at-work, productive time, productivity and efficiency, group. Starts at `date` (default today); `period` is day (default), week or month. Returned a page at a time (employee-days, sorted by date then id). Needs an admin's key. GET /employees. This is employee monitoring (personal) data: ask f
- desktime_get_employee
- One employee's summary for one day: name, email, group, arrived/left, late, online/offline/desk/at-work/productive time (seconds), productivity and efficiency. Without projects or apps; see desktime_get_employee_projects / _apps / _full for those. GET /employee/basic. This is employee monitoring (personal) data: ask for one day at a time and only what the user needs.
- desktime_get_employee_projects
- One employee's day summary plus the projects and tasks they tracked time on that day. GET /employee/projects. This is employee monitoring (personal) data: ask for one day at a time and only what the user needs.
- desktime_get_employee_apps
- One employee's day summary plus the apps, websites and titles they used that day, with durations and productivity class. Lists longer than 200 entries are cut. GET /employee/apps. This is employee monitoring (personal) data: ask for one day at a time and only what the user needs.
- desktime_get_employee_full
- One employee's day summary plus both the tracked projects/tasks and the apps/websites used that day. The largest reply: prefer the narrower tools. Lists longer than 200 entries are cut. GET /employee. This is employee monitoring (personal) data: ask for one day at a time and only what the user needs.
- desktime_list_projects
- Active (not archived) projects of the company with their tasks: id, name, creation time and tasks. Returned a page at a time. GET /projects.
- desktime_create_project
- WRITE: create a new project (and optionally one task in it) in the company's DeskTime account. Not idempotent: a second call with the same name makes another project. Returns the new project's id, url and tasks. POST /create-project.
- desktime_start_project
- WRITE: start tracking time on a project (and optionally a task) for the user the API key belongs to, by project name. This changes that user's tracked time and may switch away from the project currently running. Returns {started: true|false}. GET /start-project.
- desktime_stop_project
- WRITE: stop tracking time on a project (and optionally a task) for the user the API key belongs to, by project name. Returns {stopped: true|false}. GET /stop-project.
DeskTime MCP by usefulapi FAQ
How do I add DeskTime MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http desktime https://desktime.usefulapi.io/mcp