Clockodo

View saved version →

---
name: clockodo-time
description: Start or stop Clockodo time tracking, summarize the connected user's tracked hours, and report customer or project time for a requested period using the Clockodo MCP.
---

# Clockodo time tracking and reports

Use the connected Clockodo MCP. The server's discovered tool schemas are authoritative; the tool names below describe the expected Clockodo interface. If a tool is unavailable, explain the missing capability rather than claiming an action succeeded.

## Start tracking

Resolve the requested project with `list_projects` and its customer with `get_customer` or `list_customers`. Use returned IDs, never guessed IDs. If multiple projects match, ask the user to select one with the customer names for context. Respect archived or completed status and ask before using an inactive project.

Check `get_current_clock` before starting. If the same task is already running, report that. If another task is running, ask whether to switch before stopping it or starting a replacement. Resolve a required service through `list_services`; ask when no established default or unambiguous selection exists. Preserve project/customer billability defaults unless the user specifies otherwise.

For a start now, use `return_current_time` and `start_clock` with supported fields. A direct request to start tracking authorizes that start once the target and required fields are clear. Do not enable `clear_overlaps` or transfer durations as part of a normal start. Those options can change existing time entries. Confirm the project, customer, and start time only after the server reports success. After a timeout or unclear response, inspect the current clock before retrying a mutation.

For an explicit stop request, use `get_current_clock` and `stop_clock`, and report the server-confirmed result. Do not stop a timer simply to produce a report.

## Personal time overview

Use `get_me` to resolve the connected user's ID, timezone, and week-start setting. Filter personal results to that user explicitly. Do not treat an unfiltered company total as the user's own time.

Use `return_current_time` for relative periods. Prefer `get_entries_by_timeframe` with `users_id` when its period matches the user's calendar settings. Otherwise use `list_time_entries` with explicit timezone-aware boundaries. State the exact dates and timezone in the answer. A current week's result is week-to-date.

## Customer and project reports

Resolve customer/project names through `list_customers` and `list_projects`. A customer-wide request includes its projects and time booked directly to that customer. Do not add a current-user filter to a customer-wide request unless asked. Only include data accessible to the connected account; describe an access-limited result honestly.

For a month without a year, use the most recent occurrence of that month unless context specifies another year, and state the selected year. Ask if the intended year is still ambiguous. Use `get_entries_by_timeframe` with a custom date range and customer/project filters, or `list_time_entries` with exact boundaries. The expected `get_project_reports` tool has no date-range parameter: do not use its all-time statistics as a monthly total.

## Accurate totals

For total tracked hours, include all accessible time regardless of billability: non-billable (billable=0), billable (1), and already billed (2). Include time whose billability is unavailable when it is otherwise an accessible valid time entry. Omit the billable filter on get_entries_by_timeframe and filter.billable on list_time_entries unless the user explicitly requests a billability restriction. Do not derive a report filter from customer/project billable_default, and do not exclude zero-revenue time. A numeric billable=0 is a valid explicit filter for non-billable-only requests, not a missing value; never use a truthiness check to discard it. If the server cannot return an unfiltered set, use documented explicit filters for the

Preview of the first 4,000 characters. Read full instructions →