Clockify

Clockify's REST-based API can be used to push/pull data to/from it & integrate it with other systems

Clockify's REST API provides access to time tracking data — workspaces, projects, tasks, time entries, clients, tags, and reports. You can start/stop timers, log time entries, fetch detailed and summary reports, and manage projects programmatically. Clockify is one of the most popular free time tracking tools. For OpenClaw agents, Clockify enables automated time tracking workflows. Your agent can start/stop timers via chat commands, log time against specific projects, generate daily or weekly time reports, and alert you if you haven't tracked time today. It's especially useful for freelancers and consultants who need to track billable hours.

Tags: automation, productivity

Category: Documents & Productivity

Use Cases

  • Start/stop time tracking via chat commands ('start timer: client call')
  • Generate daily time reports and send summaries to Telegram
  • Alert if no time has been tracked by end of day via cron

Tips

  • Cache workspace and project IDs — they don't change frequently
  • Use the /reports/summary endpoint for quick daily/weekly overviews
  • Set up an end-of-day cron check: if total tracked time < 6 hours, send a reminder

Known Issues & Gotchas

  • All timestamps must be in UTC — convert from local timezone before sending
  • You need workspace ID for almost every API call — fetch it first and cache it
  • Running timers show as entries without an 'end' field — check for this when listing

Frequently Asked Questions

Is Clockify's free plan truly free with API access?

Yes. Clockify's free tier is genuinely generous — unlimited users, unlimited tracking, and full API access. Paid plans add features like invoicing, budgets, and scheduling but the core API works on free.

Can my agent start and stop timers?

Yes. Use POST to create a time entry with a start time (timer starts). To stop, PATCH the entry with an end time. You can also create completed entries with both start and end times.

How do I find my workspace and project IDs?

Call GET /workspaces to list workspaces, then GET /workspaces/{id}/projects for projects. These IDs are needed for creating time entries.