A
licenseA
qualityD
maintenanceEnables time tracking and management in Clockify through natural language commands. Supports creating time entries, managing projects, clients, and tags.
13
30 npm
MIT
Clockify MCP by usefulapi
by io.usefulapi
Server Details
Track time in Clockify: time entries, projects, clients, tags and reports; start, stop and log time.
If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
21 toolsclockify_create_clientCreate a clientInspect
WRITE: add a client to a workspace. POST /v1/workspaces/{workspaceId}/clients.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Client name (unique in the workspace). | |
| note | No | Note. | |
| No | Client email. | ||
| address | No | Client address. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_create_projectCreate a projectInspect
WRITE: create a project in a workspace (needs an admin or project-manager role, depending on workspace settings). POST /v1/workspaces/{workspaceId}/projects.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Project name, 2-250 characters (unique per client). | |
| note | No | Project note. | |
| color | No | Color, #RRGGBB. | |
| billable | No | Billable by default. | |
| client_id | No | Client id (from clockify_list_clients). | |
| is_public | No | Visible to the whole workspace. Default false: the project is private (visible to its members only). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_create_tagCreate a tagInspect
WRITE: add a tag to a workspace. POST /v1/workspaces/{workspaceId}/tags.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Tag name (unique in the workspace). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_create_taskCreate a taskInspect
WRITE: add a task to a project. POST /v1/workspaces/{workspaceId}/projects/{projectId}/tasks.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Task name. | |
| estimate | No | Time estimate, ISO 8601 duration such as PT1H30M. | |
| project_id | Yes | Project id. | |
| assignee_ids | No | User ids to assign. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_create_time_entryLog time or start a timerInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | End time. Omit to start a running timer. | |
| type | No | REGULAR (default) or BREAK. | |
| start | No | Start time, ISO 8601 with a timezone. Default: now. | |
| tag_ids | No | Tag ids (from clockify_list_tags). | |
| task_id | No | Task id on that project (from clockify_list_tasks). | |
| billable | No | Billable. Default: the project's billable setting (read from the project), else not billable. | |
| project_id | No | Project id (from clockify_list_projects). | |
| description | No | What the time was spent on. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_delete_time_entryDelete a time entryDestructiveIdempotentInspect
WRITE (destructive): permanently delete one time entry. It cannot be undone. DELETE /v1/workspaces/{workspaceId}/time-entries/{id}.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. | |
| time_entry_id | Yes | Time entry id to delete. |
clockify_detailed_reportDetailed reportRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Last day of the report, yyyy-mm-dd (inclusive). | |
| from | Yes | First day of the report, yyyy-mm-dd (inclusive). On Clockify's FREE plan a report spans at most 31 days. | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| tag_ids | No | Only these tags (ids). | |
| billable | No | true = only billable time, false = only non-billable. Default: both. | |
| user_ids | No | Only these users (ids). | |
| page_size | No | Results per page, 1-200 (default 50). | |
| time_zone | No | IANA time zone the dates are read in, e.g. Europe/Berlin. Default: your Clockify profile's time zone. | |
| client_ids | No | Only these clients (ids). | |
| description | No | Only entries whose description contains this text. | |
| project_ids | No | Only these projects (ids). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_get_current_userGet current userRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
clockify_get_projectGet a projectRead-onlyInspect
One project by id: name, client, billable, color, note, estimate, duration tracked, rates and memberships. GET /v1/workspaces/{workspaceId}/projects/{projectId}.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hydrated | No | true = include more detail (custom fields, estimates). | |
| project_id | Yes | Project id (from clockify_list_projects). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_get_running_timerGet running timerRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | No | User id. Default: you. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_get_time_entryGet a time entryRead-onlyInspect
One time entry by id: description, project, task, tags, billable, rates, custom fields and timeInterval. GET /v1/workspaces/{workspaceId}/time-entries/{id}.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hydrated | No | true = embed the project, task and tag objects. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. | |
| time_entry_id | Yes | Time entry id (from clockify_list_time_entries). |
clockify_list_clientsList clientsRead-onlyInspect
List the clients of a workspace (id, name, email, address, currency, archived). GET /v1/workspaces/{workspaceId}/clients.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only clients whose name contains this text. | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| archived | No | true = only archived clients, false = only active ones. Default: both. | |
| page_size | No | Results per page, 1-200 (default 50). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_list_projectsList projectsRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only projects whose name contains this text. | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| archived | No | true = only archived projects. Default: archived and active. | |
| billable | No | true = only billable projects. Default: all. | |
| hydrated | No | true = include more detail (custom fields, memberships, estimates). | |
| user_ids | No | Only these users (projects these users are members of) (ids). | |
| page_size | No | Results per page, 1-200 (default 50). | |
| client_ids | No | Only these clients (ids). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_list_tagsList tagsRead-onlyInspect
List the tags of a workspace (id, name, archived). GET /v1/workspaces/{workspaceId}/tags.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only tags whose name contains this text. | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| archived | No | true = only archived tags, false = only active ones. Default: both. | |
| page_size | No | Results per page, 1-200 (default 50). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_list_tasksList project tasksRead-onlyInspect
List the tasks of a project (id, name, status, assignees, estimate, duration tracked). GET /v1/workspaces/{workspaceId}/projects/{projectId}/tasks.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only tasks whose name contains this text. | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| is_active | No | true = only active tasks, false = only done tasks. Default: both. | |
| page_size | No | Results per page, 1-200 (default 50). | |
| project_id | Yes | Project id (from clockify_list_projects). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_list_time_entriesList time entriesRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Only entries starting before this time (ISO 8601 with a timezone). | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| start | No | Only entries starting at or after this time (ISO 8601 with a timezone). | |
| tag_ids | No | Only these tags (ids). | |
| task_id | No | Only entries on this task. | |
| user_id | No | User id (from clockify_list_users). Default: you. Other users' entries need an admin or manager role. | |
| hydrated | No | true = embed the project, task and tag objects instead of ids only. | |
| page_size | No | Results per page, 1-200 (default 50). | |
| project_id | No | Only entries on this project. | |
| description | No | Only entries whose description contains this text. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_list_usersList workspace usersRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Only users whose name contains this text. | |
| page | No | Page number, from 1 (default 1). Pass the previous reply's next_page. | |
| No | Only users whose email contains this text. | ||
| status | No | Membership status filter. | |
| page_size | No | Results per page, 1-200 (default 50). | |
| project_id | No | Only users with access to this project. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_list_workspacesList workspacesRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| roles | No | Only workspaces where you have one of these roles. |
clockify_stop_timerStop running timerDestructiveInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Stop time, ISO 8601 with a timezone. Default: now. | |
| user_id | No | User id. Default: you. Stopping someone else's timer needs an admin role. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_summary_reportSummary reportRead-onlyInspect
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.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Last day of the report, yyyy-mm-dd (inclusive). | |
| from | Yes | First day of the report, yyyy-mm-dd (inclusive). On Clockify's FREE plan a report spans at most 31 days. | |
| tag_ids | No | Only these tags (ids). | |
| billable | No | true = only billable time, false = only non-billable. Default: both. | |
| group_by | No | Grouping levels, outermost first (default [PROJECT, TIMEENTRY]). | |
| user_ids | No | Only these users (ids). | |
| time_zone | No | IANA time zone the dates are read in, e.g. Europe/Berlin. Default: your Clockify profile's time zone. | |
| client_ids | No | Only these clients (ids). | |
| description | No | Only entries whose description contains this text. | |
| project_ids | No | Only these projects (ids). | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. |
clockify_update_time_entryUpdate a time entryDestructiveIdempotentInspect
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 then PUT /v1/workspaces/{workspaceId}/time-entries/{id}.
ParametersJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | New end time (also stops a running timer). | |
| start | No | New start time. | |
| tag_ids | No | New tag ids (replaces the tags; [] removes them all). | |
| task_id | No | New task id (on the entry's project). | |
| billable | No | New billable flag. | |
| project_id | No | New project id. | |
| description | No | New description. | |
| workspace_id | No | Workspace id (from clockify_list_workspaces). Default: your active workspace. | |
| time_entry_id | Yes | Time entry id. |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
21 tool updates
- First observed
clockify_create_client - First observed
clockify_create_project - First observed
clockify_create_tag - First observed
clockify_create_task - First observed
clockify_create_time_entry - First observed
clockify_delete_time_entry - First observed
clockify_detailed_report - First observed
clockify_get_current_user - First observed
clockify_get_project - First observed
clockify_get_running_timer - First observed
clockify_get_time_entry - First observed
clockify_list_clients - First observed
clockify_list_projects - First observed
clockify_list_tags - First observed
clockify_list_tasks - First observed
clockify_list_time_entries - First observed
clockify_list_users - First observed
clockify_list_workspaces - First observed
clockify_stop_timer - First observed
clockify_summary_report - First observed
clockify_update_time_entry
Related MCP Connectors
Track time on usetimebook.com - start/stop timers, log entries, list projects/clients.
Read time entries, projects, clients, tasks and invoices; log and update tracked time.
Timen time tracking — timers, time entries, reports, projects, and clients.
Timer and time-tracking add-on: start/stop timers, log entries, CSV export. Data stays local.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables time tracking and project management through the Clockify API. Supports starting/stopping timers, logging time entries, managing projects and tasks, and generating reports with natural language commands.2111 npmMIT
- AlicenseNot gradedqualityDmaintenanceIntegrates with Clockify time tracking API to retrieve user information, manage projects, and log time entries with flexible time specifications across workspaces.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Clockify time tracking API to manage time entries, projects, tasks, and workspaces through natural language commands.24 npm5ISC
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd
Glama MCP Gateway
Add one secure layer between your agents and this server.