# DeskTime MCP by usefulapi

> DeskTime MCP by usefulapi is an MCP server. Read tracked time and projects; create projects and start or stop timers in DeskTime. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/desktime/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/desktime
- **MCP Registry name:** io.usefulapi/desktime
- **Listing updated:** 2026-11-13

## About

Read tracked time and projects; create projects and start or stop timers in DeskTime.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http desktime https://desktime.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://desktime.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "desktime": {
      "url": "https://desktime.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "desktime": {
      "type": "http",
      "url": "https://desktime.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "desktime": {
      "serverUrl": "https://desktime.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "desktime": {
      "type": "http",
      "url": "https://desktime.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/desktime-mcp-by-usefulapi
