Generate an API key in Clockify by navigating to Profile Settings in the Clockify web app; this key is used for all API authentication.
Include the API key in the X-Api-Key request header on all calls to the Clockify REST API base URL https://api.clockify.me/api/v1.
GET /workspaces to retrieve workspace IDs; most endpoints require a workspaceId path parameter.
GET /workspaces/{workspaceId}/time-entries with optional query parameters (user, project, start, end) to retrieve time entries for the workspace.
For aggregated or cross-user reporting use the Reports API (a separate endpoint family) which supports detailed, summary, and weekly report types with richer filtering options.
Handle pagination using the page and page-size query parameters; the API returns up to a configurable number of records per page.
Known gotchas
Clockify workspaces on custom subdomains (e.g., company.clockify.me) require a workspace-specific API key generated from that subdomain's settings—keys from the main clockify.me domain will not authenticate.
The free plan enforces a rate limit of approximately 30 requests per hour per workspace; paid plans have higher limits—check the docs.clockify.me rate limit documentation for current values.
Time entries belong to individual users; to export all entries across a workspace you must either iterate over all users or use the Reports API which aggregates across users.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp