# Clockify MCP by usefulapi

> Clockify MCP by usefulapi is an MCP server. Track time in Clockify: time entries, projects, clients, tags and reports; start, stop and log time. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

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

## Install

### Claude Code (Terminal)

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

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

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

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

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

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

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

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

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

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

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

## Tools

- `clockify_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 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.
- `clockify_list_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.
- `clockify_list_clients`: List the clients of a workspace (id, name, email, address, currency, archived). GET /v1/workspaces/{workspaceId}/clients.
- `clockify_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.
- `clockify_get_project`: One project by id: name, client, billable, color, note, estimate, duration tracked, rates and memberships. GET /v1/workspaces/{workspaceId}/projects/{projectId}.
- `clockify_list_tasks`: List the tasks of a project (id, name, status, assignees, estimate, duration tracked). GET /v1/workspaces/{workspaceId}/projects/{projectId}/tasks.
- `clockify_list_tags`: List the tags of a workspace (id, name, archived). GET /v1/workspaces/{workspaceId}/tags.
- `clockify_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.
- `clockify_get_time_entry`: One time entry by id: description, project, task, tags, billable, rates, custom fields and timeInterval. GET /v1/workspaces/{workspaceId}/time-entries/{id}.
- `clockify_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.
- `clockify_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.
- `clockify_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.
- `clockify_create_time_entry`: 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.
- `clockify_stop_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.
- `clockify_update_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 t
- `clockify_delete_time_entry`: WRITE (destructive): permanently delete one time entry. It cannot be undone. DELETE /v1/workspaces/{workspaceId}/time-entries/{id}.
- `clockify_create_project`: WRITE: create a project in a workspace (needs an admin or project-manager role, depending on workspace settings). POST /v1/workspaces/{workspaceId}/projects.
- `clockify_create_task`: WRITE: add a task to a project. POST /v1/workspaces/{workspaceId}/projects/{projectId}/tasks.
- `clockify_create_client`: WRITE: add a client to a workspace. POST /v1/workspaces/{workspaceId}/clients.
- `clockify_create_tag`: WRITE: add a tag to a workspace. POST /v1/workspaces/{workspaceId}/tags.

## FAQ

### How do I add Clockify MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http clockify https://clockify.usefulapi.io/mcp

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