Skip to main content
Was this helpful?

Time Tracking

note

PrimeCal v1.3.4 does not include dedicated time tracking — there is no timer, no "log time" button, no timeSpent field on events or tasks, and no timesheet report. This page explains what is available and how to use it for approximate time accounting.

What PrimeCal has that relates to time​

Event duration (calendar-as-time-log approach)​

Each event has a start and end time. The difference is the event's duration — a 9:00–10:30 event represents 1.5 hours. If you block time on your calendar for focused work the way you would for meetings, your calendar becomes a rough time log: the events show what you worked on and for how long.

This is the most common workaround in calendar-centric time tracking:

  1. Create a calendar event for each work block — title it with the project or task name.
  2. Keep the event duration accurate to how long you actually worked (resize it in the Week view if you finished early or ran over).
  3. At the end of the week, look at the Week view to see your time allocation visually, or query the events API (GET /api/events) to sum durations programmatically.

The Week view in PrimeCal renders events as proportionally sized blocks, so a week of blocked time is immediately readable as a rough breakdown of where time went.

Tasks workspace​

The Tasks workspace tracks work by status (to-do, in progress, done), priority, and due date. It does not record how long a task took or track elapsed time. There is no time log attached to tasks.

Tasks can be linked to calendar events (the mirroredEvent relationship on the task entity), but this is a reference link, not a time-tracking integration. The duration of the linked event does not automatically count toward any task total.

See Tasks Workspace for how to use tasks effectively within these constraints.

Automation for categorization​

You can use automation rules to classify events by project or type automatically — for example, coloring all events whose title starts with a project code in a specific color. This makes it easier to visually tally time by project in the Week view, without manual categorization.

See Introduction To Automation for how to set this up.

Using PrimeCal alongside a dedicated time tracker​

If you need precise time tracking — billable hours by client, reports for payroll, or stopwatch-style logging — use a dedicated time tracking tool (Toggl Track, Harvest, Clockify, etc.) alongside PrimeCal. Several of these tools can be connected to PrimeCal via automation webhooks:

  1. Create an automation rule in PrimeCal with a webhook.incoming trigger.
  2. Configure the time tracker to POST a webhook to PrimeCal's webhook URL when a time entry is started or stopped.
  3. Use condition matching to filter for relevant entries, and use automation actions (currently: set event color) to reflect the tracking status on your calendar.

This integration requires some technical setup but keeps PrimeCal's calendar in sync with your time tracker's activity.

What's on the roadmap​

Native time-tracking features — elapsed timers on tasks, logged hours, and timesheet summaries — are not currently scheduled for a specific release. This page will be updated if that changes.

Continue Reading​