Time Management

Clockodo MCP Server

Connect your account, then chat with AI to run tools.

Clockodo is a time tracking software designed for businesses to monitor employee work hours, project durations, and generate related reports. Utilize it to track time efficiently and bill clients accurately.

25 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Clockodo — workflow patterns, data models, and gotchas for your AI agent.

Clockodo

Clockodo is a time-tracking platform for businesses. This bundle provides full CRUD access to time entries, projects, customers, and absences, plus read-only access to leave balances, team structures, services, and workforce reports.

Entity Hierarchy

  • Customers own Projects. Projects are the primary grouping for time entries.
  • Users belong to Teams and log Entries (time records) against projects/services.
  • Services and Lumpsum Services define billable work categories. Surcharges attach modifiers.
  • Absences track leave (vacation, sick, etc.). Holidays Quota/Carry and Overtime Carry track balances per employee.
  • Target Hours define expected weekly/monthly hours per user.
  • Non Business Days are public holidays or company-wide days off.

CRUD Capabilities

Full CRUD (create, read, update, delete):

  • Entries — create time entries with customer/service/time, update descriptions or billable status, delete wrong entries.
  • Customers — create new clients, update names or billing defaults, delete inactive customers.
  • Projects — create projects under customers, update status or notes, delete completed projects.
  • Absences — create leave requests with type/dates, update notes or dates, delete cancelled leave.

Read-only:

  • Users, Teams, Services, Lumpsum Services, Surcharges (organization config)
  • Holiday Carry, Holiday Quota, Overtime Carry, Target Hours (balance data)
  • Non-Business Days, User Reports, Work Times (reference/reporting)

Workflows

Log and audit time: Create entries with customer, service, and time range. Omit time_until to start a running timer. Paginate through large entry sets for auditing. Cross-reference with projects and customers for billing context.

Manage clients and projects: Create customers, then create projects under them. Update billable defaults or deactivate stale records.

Handle leave requests: Create absences with type (1=vacation, 2=special leave, 3=overtime reduction, 4=sick day). Check holiday quotas and carryover balances to validate remaining leave. Delete cancelled requests.

Understand org structure: List users and teams. To see which customers and projects a specific user can access, you need the user's ID first — fetch the users list, then query their customer/project access permissions.

Generate reports: User reports summarize activity across a period. Work times provide the raw hour-by-hour data.

Pagination

Customers, projects, services, and entries support pagination via page (cursor token) and items_per_page (default 1000). Other endpoints return all records in a single response.

Gotchas

  • User ID dependency: Viewing a user's customer/project access requires their numeric user ID. Fetch the users list first.
  • Absences require year: The absences list endpoint requires a year parameter.
  • Entry creation requires IDs: Creating a time entry needs customers_id, services_id, and time_since. Fetch customers and services first to get valid IDs.
  • German locale: Clockodo is Germany-focused; date formats and non-business days default to German conventions.

Tools in this Server (25)

Clockodo Delete Absence

Permanently delete an absence record. This cannot be undone.

Clockodo Delete Customer

Permanently delete a customer and all associated projects. This cannot be undone.

Clockodo Delete Entry

Permanently delete a time entry. This cannot be undone.

Clockodo Delete Project

Permanently delete a project. This cannot be undone. All time entries remain but lose their project association.

Clockodo Get Absences

Get absences (vacation, sick, etc.). Pass absence_id for a single record with full details, or omit to list all. When listing, provide year to filter ...

Clockodo Get Customers

Get customers. Pass customer_id for a single customer with full details, or omit to list all. Customers own projects — use this to understand the bill...

Clockodo Get Customers Projects

Get which customers and projects a specific user can access. Requires user_id — fetch the users list first to get IDs.

Clockodo Get Entries

Get time entries. Pass entry_id for a single entry with full details, or omit to list all. Entries are logged against projects and services. Paginate ...

Clockodo Get Lumpsum Services

Get lumpsum (fixed-price) service definitions. Pass lumpsum_service_id for a single service, or omit to list all. These are billable work categories t...

Clockodo Get Projects

Get projects. Pass project_id for a single project with full details, or omit to list all. Projects belong to customers and are the primary grouping f...

Clockodo Get Services

Get hourly service definitions. Pass service_id for a single service, or omit to list all. Time entries reference services to categorize what work was...

Clockodo Get Surcharges

Get surcharge modifiers. Pass surcharge_id for a single surcharge, or omit to list all. Surcharges (e.g. overtime rates, weekend premiums) attach to t...

Clockodo Get Teams

Get teams. Pass team_id for a single team with full details, or omit to list all. Users belong to teams — use this to understand organizational struct...

Clockodo Get Users

Get users. Pass user_id for a single user with full details, or omit to list all. Fetch users first when you need a user_id for other endpoints (e.g. ...

Clockodo List Holidays Carry

Get holiday carryover balances — unused leave days carried into the next period per employee.

Clockodo List Holidays Quota

Get annual leave entitlements (holiday quotas) allocated per employee. Compare with absences and carryover to assess remaining leave.

Clockodo List Non Business Days

List public holidays and company-wide days off. Clockodo defaults to German conventions for non-business day calendars.

Clockodo List Overtime Carry

Get overtime balances carried into the current period per employee. Use with target hours to assess capacity.

Clockodo List Target Hours

Get expected weekly/monthly working hours per user. Compare with actual entries and overtime carry to assess capacity and compliance.

Clockodo List User Reports

Get summary activity reports per user for a period — hours worked, project breakdown, and task completion.

Clockodo List Work Times

Get raw hour-by-hour work time records. Returns user ID, date, and hours worked per day. Paginate with page token for large result sets.

Clockodo Upsert Absence

Create or update an absence (leave request). To create: provide date_since, date_until, and type (required). To update: provide absence_id plus fields...

Clockodo Upsert Customer

Create or update a customer. To create: provide name (required). To update: provide customer_id plus fields to change.

Clockodo Upsert Entry

Create or update a time entry. To create: provide customers_id, services_id, and time_since. Omit time_until to start a running timer. To update: prov...

Clockodo Upsert Project

Create or update a project. To create: provide name and customers_id (required). To update: provide project_id plus fields to change.

Frequently Asked Questions

What is the Clockodo MCP server?

Clockodo is a time tracking software designed for businesses to monitor employee work hours, project durations, and generate related reports. Utilize it to track time efficiently and bill clients accurately. It provides 25 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Clockodo to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/clockodo. Authentication is handled automatically.

How many tools does Clockodo provide?

Clockodo provides 25 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Clockodo require?

Clockodo uses API Key. Clockodo requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Clockodo to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/clockodo

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Ready to use Clockodo?

Sign in to connect your credentials and start running tools from the chat.

Clockodo MCP Server & Skill — 25 Tools