Provides Clockodo time entries as a subscribable iCal feed (RFC 5545).
This tool converts your time entries from Clockodo into a dynamic calendar feed that you can subscribe to in Google Calendar, Apple Calendar, Outlook, or other iCal-compatible applications.
The easiest way to use it is by accessing the hosted domain directly. No installation is required. All configurations are handled via URL parameters.
https://clockodo.ical.dev/?user=your@email.com&token=YOUR_API_KEY
| Parameter | Required | Description | Default |
|---|---|---|---|
user |
Yes | Your Clockodo login email (API user). | — |
token |
Yes | Your Clockodo API key (found in Clockodo settings). | — |
days |
No | Lookback period in days. | 180 |
limit |
No | Maximum number of entries to retrieve. | 1000 |
The project is intentionally minimalist: a single PHP file, no external dependencies for production.
- PHP 8.5+
- cURL extension enabled
- Composer (for development only)
You can run the service locally using Docker:
-
Clone the repository:
git clone https://github.com/DOEBELING/Clockodo.ICal.dev.git cd Clockodo.ICal.dev -
Start:
docker-compose up -d
-
Access: The service will be available at
http://localhost:8088.
The script queries the Clockodo API (/api/v2/entries and /api/v2/projects) and transforms the data into iCal format. It considers all entry types:
- Type 1: Time entries
- Type 2: Fixed prices
- Type 3: Fixed services
Project budgets are also retrieved and integrated into the description of the calendar events.
The hosted service at clockodo.ical.dev is provided with privacy in mind:
- Hosting: The service is hosted on servers located in Germany (Hetzner).
- Delivery: Content may be delivered via Cloudflare (CDN) to ensure performance and security.
- Data Processing: No data is permanently stored on our servers. Your Clockodo API credentials are used only to fetch data from Clockodo in real-time and are not logged.
For more details, please refer to our Privacy Policy (Datenschutzerklärung).
- Copyright: DÖBELING Projektbüro
- Author: Andreas Döbeling
- License: GPL-3.0
Disclaimer: This project is not officially affiliated with clockodo GmbH.