> For the complete documentation index, see [llms.txt](https://docs.coupler.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coupler.io/sources/category/time-tracking/clockify.md).

# Clockify

Clockify is a time tracking platform that helps teams log hours, track projects, and generate detailed time reports. With Coupler.io, you can automatically sync your Clockify time data to Google Sheets, BigQuery, Looker Studio, or other destinations to build live dashboards and reports without manual exports.

## Why connect Clockify to Coupler.io?

* **Automate time reporting** — Pull Summary, Detailed, or Weekly reports directly into your spreadsheets or data warehouse
* **Real-time dashboards** — Keep your time tracking metrics up-to-date with scheduled refreshes
* **No manual exports** — Eliminate copy-paste workflows and sync data on a schedule
* **Multi-destination support** — Send data to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT for analysis

## Prerequisites

* A Clockify account with workspace admin access (required to retrieve your Workspace ID)
* An API key generated from your Clockify profile settings
* A destination account (Google Sheets, BigQuery, Excel, etc.)

## Quick start

{% hint style="success" %}
If you're new to Coupler.io, start with the **Summary** report to test the connection. It's the simplest report type and helps you verify your credentials are correct before moving to Detailed or Weekly reports.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Sign in to Coupler.io** and create a new data flow. Select **Clockify** as your source.
{% endstep %}

{% step %}
**Get your Workspace ID.** Log in to Clockify, go to **Settings** in the Manage section, and copy the ID from the URL address bar. For example, in the URL `https://clockify.me/workspaces/5e450bcf1fffab54e1b0e8e5/settings`, the workspace ID is `5e450bcf1fffab54e1b0e8e5`. (You must be a workspace admin to access this.)
{% endstep %}

{% step %}
**Generate an API key.** Go to your [Clockify profile settings](https://clockify.me/user/settings), scroll to the API section at the bottom, and click **Generate**. Copy the key.
{% endstep %}

{% step %}
**Enter your credentials in Coupler.io.** Paste your Workspace ID and API key into the connection form.
{% endstep %}

{% step %}
**Choose a report type.** Select **Summary**, **Detailed**, or **Weekly** depending on the level of detail you need.
{% endstep %}

{% step %}
**Set your date range (optional).** Use the date picker to specify start and end dates. If left blank, the default range is one month from the start date. Macros are supported for dynamic date ranges (e.g., `{{lastweekstart}}`—see FAQ for examples).
{% endstep %}

{% step %}
**Choose your destination.** Select Google Sheets, BigQuery, Excel, Looker Studio, or an AI destination (Claude, ChatGPT, Gemini, etc.).
{% endstep %}

{% step %}
**Run the data flow manually.** Click **Run** to test the connection and verify data is pulling correctly. A successful manual run is required before you can schedule automatic refreshes.
{% endstep %}
{% endstepper %}

## Report types overview

| Report Type  | Best For              | Details                                                                      |
| ------------ | --------------------- | ---------------------------------------------------------------------------- |
| **Summary**  | High-level metrics    | Total hours by project, user, or date. Simplest report; good for dashboards. |
| **Detailed** | Complete time entries | Individual time entries with descriptions, tags, and billable status.        |
| **Weekly**   | Weekly analysis       | Hours aggregated by week. Useful for weekly planning and capacity reports.   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.coupler.io/sources/category/time-tracking/clockify.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.