Skip to content
Book a demoStart free
Connectors

Clockodo connector

Set up the Clockodo connector in Kaivo: authentication, configuration, the 17 BigQuery tables it syncs, and answers to common questions.

Clockodo connector pricing, tier and credits on kaivo.io

Kaivo is a fully managed data platform that syncs your Clockodo data into a Google BigQuery warehouse and keeps it up to date automatically. There is no pipeline to build and no infrastructure to run, so you can spend your time analysing your HR data instead of moving it.

Sync your Clockodo time tracking data into BigQuery with Kaivo to analyse hours, absences, and project profitability.

CategoryHR, Project Management
AuthenticationAPI key
SetupSelf-service

Getting started with the Clockodo connector

Section titled “Getting started with the Clockodo connector”
  1. Sign up for Kaivo and create a workspace.
  2. Connect your Clockodo account.
  3. Choose which tables to sync.
  4. Wait for the initial sync to finish.
  5. Query your data in BigQuery or your favourite AI or BI tool.

Authenticate with your API Key.

Field Description
API Key
API key to use. Find it in the ‘Personal data’ section of your Clockodo account.

|

When you set up the connector, you provide:

Field Description
Email Address
Your Clockodo account email address. Find it in your Clockodo account settings.

| | Years |

List of years to sync data for, e.g. 2024, 2025.

| | Start Date |

Any data before this date will not be fetched.

|

Kaivo syncs 17 tables from Clockodo into a dedicated dataset in your BigQuery warehouse. Click any table to see its columns and types.

absences (11 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type FLOAT64
approved_by FLOAT64
count_days FLOAT64
date_approved STRING
date_since STRING
date_until STRING
id FLOAT64
status FLOAT64
users_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customers (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active BOOL
billable_default BOOL
color FLOAT64
id FLOAT64
name STRING
test_data BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
customers_projects (6 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
add BOOL
edit BOOL
report JSON
user_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
entries (25 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type FLOAT64
billable FLOAT64
clocked BOOL
clocked_offline BOOL
customers_id FLOAT64
duration FLOAT64
hourly_rate FLOAT64
id FLOAT64
lumpsum FLOAT64
lumpsum_services_amount FLOAT64
lumpsum_services_id FLOAT64
projects_id FLOAT64
services_id FLOAT64
test_data BOOL
text STRING
texts_id FLOAT64
time_clocked_since STRING
time_insert STRING
time_last_change STRING
time_last_change_work_time STRING
time_since STRING
time_until STRING
users_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
holidays_carry (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
count FLOAT64
id FLOAT64
note STRING
users_id FLOAT64
year FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
holidays_quota (8 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
count FLOAT64
id FLOAT64
note STRING
users_id FLOAT64
year_since FLOAT64
year_until FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
lumpsum_services (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active BOOL
id FLOAT64
name STRING
price FLOAT64
unit STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
non_business_days (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
half_day FLOAT64
id FLOAT64
name STRING
nonbusinessgroups_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
overtime_carry (7 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
hours FLOAT64
id FLOAT64
note STRING
users_id FLOAT64
year FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
projects (14 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active BOOL
billable_default BOOL
billed_completely BOOL
budget_is_hours BOOL
budget_is_not_strict BOOL
budget_money FLOAT64
completed BOOL
customers_id FLOAT64
id FLOAT64
name STRING
revenue_factor FLOAT64
test_data BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
services (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active BOOL
id FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
surcharges (20 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
accumulation BOOL
id FLOAT64
name STRING
nonbusiness__percent FLOAT64
nonbusiness__time_since STRING
nonbusiness__time_since_is_previous_day BOOL
nonbusiness__time_until STRING
nonbusiness__time_until_is_next_day BOOL
nonbusiness_special__percent FLOAT64
nonbusiness_special__time_since STRING
nonbusiness_special__time_since_is_previous_day BOOL
nonbusiness_special__time_until STRING
nonbusiness_special__time_until_is_next_day BOOL
sunday__percent FLOAT64
sunday__time_since STRING
sunday__time_since_is_previous_day BOOL
sunday__time_until STRING
sunday__time_until_is_next_day BOOL
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
target_hours (17 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
type STRING
compensation_daily FLOAT64
compensation_monthly FLOAT64
date_since STRING
date_until STRING
friday FLOAT64
id FLOAT64
monday FLOAT64
saturday FLOAT64
sunday FLOAT64
test_data BOOL
thursday FLOAT64
tuesday FLOAT64
users_id FLOAT64
wednesday FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
teams (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
id FLOAT64
leader FLOAT64
name STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
user_reports (31 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
diff FLOAT64
holidays_carry FLOAT64
holidays_quota FLOAT64
overtime_carryover FLOAT64
overtime_reduced FLOAT64
sum_absence__home_office FLOAT64
sum_absence__maternity_protection FLOAT64
sum_absence__military_service FLOAT64
sum_absence__out_of_office FLOAT64
sum_absence__quarantine FLOAT64
sum_absence__regular_holidays FLOAT64
sum_absence__school FLOAT64
sum_absence__sick_child FLOAT64
sum_absence__sick_self FLOAT64
sum_absence__special_leaves FLOAT64
sum_hours FLOAT64
sum_reduction_planned FLOAT64
sum_reduction_used FLOAT64
sum_target FLOAT64
surcharges__night FLOAT64
surcharges__night_increased FLOAT64
surcharges__nonbusiness FLOAT64
surcharges__nonbusiness_special FLOAT64
surcharges__saturday FLOAT64
surcharges__sunday FLOAT64
users_email STRING
users_id FLOAT64
users_name STRING
workdays FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
users (23 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
active BOOL
can_add_customers BOOL
can_generally_manage_absences BOOL
can_generally_see_absences BOOL
creator FLOAT64
default_holidays_count BOOL
default_target_hours BOOL
edit_lock_sync BOOL
email STRING
id FLOAT64
initials STRING
language STRING
name STRING
role STRING
support_pin STRING
timeformat_12h BOOL
timezone STRING
weekend_friday BOOL
weekstart_monday BOOL
work_time_edit_lock_days FLOAT64
worktime_regulation_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
value FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
work_times (5 columns)
Column Type Description
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
date STRING
offset FLOAT64
users_id FLOAT64
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.
Column Type Description
_kaivo_parent_id STRING Foreign key referencing _kaivo_id in the parent table. Auto-generated by Kaivo.
_kaivo_id STRING Primary key that uniquely identifies the row. Auto-generated by Kaivo.
time_since STRING
time_until STRING
_kaivo_extracted_at TIMESTAMP Timestamp that shows when the row was extracted. Auto-generated by Kaivo.

After the first load, Kaivo keeps your BigQuery warehouse up to date for you. Where Clockodo supports it, each sync pulls only new and changed records so it stays fast; otherwise it refreshes the whole table. Every record keeps its original ID, so you won’t get duplicate rows.

How long does the initial sync take for Clockodo?

Section titled “How long does the initial sync take for Clockodo?”

It depends on how much history is in your Clockodo account. Most initial syncs finish within minutes, while large accounts can take a few hours. After that, syncs only fetch new and changed records, so they’re much faster.

Yes. You pick which tables to sync when you set up the connection and can change the selection later. Tables you don’t select are never copied to your warehouse.

What happens when Clockodo’s schema changes?

Section titled “What happens when Clockodo’s schema changes?”

New fields are never added automatically. You choose which fields to sync, so data you haven’t selected (sensitive personal data, for example) never lands in your warehouse. When a new field appears, it becomes available for you to add. What happens to removed or renamed fields depends on a table’s sync mode: full-refresh tables always match what’s currently in Clockodo, so dropped fields disappear, while incremental tables keep their existing columns and history, so an old field stays and newly added fields fill in over time.

How do I handle GDPR or data deletion requests?

Section titled “How do I handle GDPR or data deletion requests?”

Your data lives in your own Kaivo-managed BigQuery warehouse, so the most direct option is to delete or anonymise specific records right in BigQuery. If you delete data in Clockodo instead, full-refresh tables drop it on the next sync, while incremental tables keep it, so you would remove the row in BigQuery or ask us to run a full refresh. To remove everything, delete the Clockodo connector in Kaivo and all of its synced data is deleted with it.

Use entries to track logged hours by project and customer over time.

Join entries with projects and target_hours to compare logged time against budgets.

Use absences and holidays_quota to monitor leave and capacity.

Once Clockodo data lands in your Kaivo-managed BigQuery warehouse, you can explore it with AI tools or any BI tool that connects to BigQuery. Here’s how the most common destinations work with Clockodo data.

Use Kaivo’s MCP server to give Claude secure, workspace-scoped access to your data. Setup guide →

Microsoft’s BI tool with a native BigQuery connector. Supports direct query and scheduled refresh. Setup guide →

Free Google BI tool with native BigQuery support. One-click connection to your Kaivo warehouse; great for SMB teams on Google Workspace. Setup guide →

The premium analytics standard, with native BigQuery integration. Setup guide →

Use Connected Sheets to query BigQuery directly from a spreadsheet, with no SQL. Setup guide →

Connect via Power Query’s BigQuery connector. Setup guide →

Open-source BI tool with strong BigQuery support. Setup guide →

See our pricing page for Clockodo connector pricing and plan details.

  • ClickUp: Sync ClickUp to BigQuery.
  • GitHub: Sync GitHub to BigQuery.
  • GitLab: Sync GitLab to BigQuery.
  • Greenhouse: Sync Greenhouse to BigQuery.
  • Harvest: Sync Harvest to BigQuery.
  • Jira: Sync Jira to BigQuery.