A Home Assistant custom integration for Clockify time tracking. Track your current timer status, start/stop time entries, and see your daily/weekly/monthly hours directly in Home Assistant.
switchentity to start/stop the Clockify timer for a configured projectsensorentities for timer status and hours logged today/this week/this month- Real-time updates via Clockify webhooks
- Make sure HACS is installed.
- In HACS, go to Integrations, click the three-dot menu, choose Custom repositories, and add this repository URL with category Integration (only needed until this integration is available in the default HACS list).
- Search for "Clockify" in HACS and install it.
- Restart Home Assistant.
- Copy the
custom_components/clockifyfolder into your Home Assistantconfig/custom_components/directory. - Restart Home Assistant.
Configuration is done via the UI:
- Create a Clockify API key at app.clockify.me/manage-api-keys and copy it.
- In Home Assistant, go to Settings → Devices & Services → Add Integration, search for "Clockify", and paste in the API key.
- Select the workspace and project you want to track.
- Home Assistant will generate two webhook URLs (one for timer started, one for timer stopped). Go to app.clockify.me/webhooks and create two webhooks, pasting in the matching URL for each:
- Timer started (anyone) → the "started" URL
- Timer stopped (anyone) → the "stopped" URL
Webhooks let Clockify push timer changes to Home Assistant instantly instead of the integration having to poll the Clockify API on a schedule, which keeps API usage low and avoids hitting Clockify's rate limits, even on a free-tier.
See LICENSE.