Skip to content
MCP server

Clockify MCP by usefulapi

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

Install
Runs
Remotely
Version
1.28.0
Listing updated
4 days ago

About Clockify MCP by usefulapi

Clockify MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://clockify.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "clockify": {
      "url": "https://clockify.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": {
    "clockify": {
      "type": "http",
      "url": "https://clockify.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (21)

Read directly from the server.

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.

Clockify MCP by usefulapi 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