otherapi_key

Clockify

Clockify is a free time tracking software that allows individuals and teams to track work hours across projects.

Verdict

Clockify tracks time across projects and clients. In Switchy, @mention Clockify to pull team timesheets, create clients, filter workspace users, or manage webhooks — all without leaving your Space. Most useful for project managers reconciling hours, ops teams auditing billable time, or anyone automating time-entry workflows. Requires an API key from your Clockify workspace settings. No OAuth dance, but you'll need workspace admin rights to create clients or webhooks.

Common use cases

  • Pull weekly timesheets for billing review
  • Create new clients from project kickoff notes
  • Audit who logged hours on a sprint
  • Set up webhooks for time-entry alerts
  • Filter users by team or billable status

Integration

Vendor
Clockify
Category
other
Auth
API_KEY
Tools
19
Composio slug
clockify

Tools

  • Create Client

    Tool to add a new client to a workspace. use when you need to create a client in a specific workspace.

  • Create Webhook

    Tool to create a new webhook in a workspace. use when you want to subscribe to workspace events by registering a callback url.

  • Delete Client
    destructive

    Tool to delete a client from a workspace. use after archiving the client and confirming no associated data exists.

  • Delete Webhook
    destructive

    Tool to delete a webhook from a workspace. use when you need to remove an existing webhook by its id.

  • Filter Workspace Users

    Tool to filter users in a workspace by advanced criteria. use when you need a paginated, sortable list of workspace users matching multiple filters.

  • Find All Users On Workspace

    Tool to list all users in a workspace. use when you need to retrieve workspace members after confirming the workspace id. example: "find all users on workspace 64a687e29ae1f428e7ebe303."

  • Find User's Team Managers

    Tool to get managers of a user in a workspace. use after confirming workspace and user ids are correct.

  • Generate New Webhook Token

    Tool to generate a new webhook token. use after confirming workspace and webhook ids.

  • Get All Addon Webhooks

    Tool to list all webhooks for an addon in a workspace. use after confirming workspace and addon ids.

  • Get All My Workspaces

    Tool to list all workspaces the user belongs to. use when you need an overview of accessible workspaces after authentication.

  • Get All Webhooks

    Tool to list all webhooks in a workspace. use when you need to retrieve defined webhooks after confirming the workspace id.

  • Get Client By ID

    Tool to get details of a client by id. use after confirming workspace and client ids.

  • Get Clients

    Tool to list clients in a workspace. use after obtaining a workspace id.

  • Get Currently Logged In User Info

    Tool to retrieve info about the authenticated user. use when verifying credentials and needing current user context after authentication.

  • Get Holidays

    Tool to retrieve all holidays for a workspace. use when you need to list or filter workspace holidays after confirming the workspace id.

  • Get Holidays In Period

    Tool to retrieve holidays in a specific period. use when you need holidays assigned to a user between two dates after confirming the workspace id.

  • Get member's profile

    Tool to get a member's profile in a workspace. use when you need detailed profile info after identifying the workspace and user.

  • Get Webhook By ID

    Tool to get details of a specific webhook. use after confirming workspace and webhook id.

  • Get Workspace Info

    Tool to get details of a specific workspace. use after obtaining the workspace id.

Setup

Setup guide

  1. 11. Open your Clockify workspace, navigate to Settings > API, and generate a new API key. 2. In Switchy, click Integrations in the left sidebar, find Clockify, and select Connect. 3. Paste your API key into the prompt and confirm. 4. Switchy tests the connection by fetching your workspace ID — if it succeeds, you'll see a green checkmark. 5. Open any Space, type '@Clockify list all users in workspace [your-workspace-id]' and send. 6. If Clockify replies with a user list, the integration is live. 7. To create clients or webhooks, confirm your Clockify role has admin permissions — viewer-level keys can read data but not write. 8. Store your workspace ID in the Space's context if you'll invoke Clockify often; it saves you typing the ID every time.

What teammates see: by default, memories from Clockify are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

List Workspace Users

@Clockify find all users on workspace 64a687e29ae1f428e7ebe303
Open in a Space →

Create New Client

@Clockify create a client named 'Acme Corp' in workspace 64a687e29ae1f428e7ebe303
Open in a Space →

Filter Active Users

@Clockify filter workspace users in 64a687e29ae1f428e7ebe303 where status is active and sort by name
Open in a Space →

Set Up Webhook

@Clockify create a webhook in workspace 64a687e29ae1f428e7ebe303 with callback url https://example.com/clockify-events
Open in a Space →

Find Team Managers

@Clockify find team managers for user 507f1f77bcf86cd799439011 in workspace 64a687e29ae1f428e7ebe303
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Clockify show me all active time entries for our team this week, grouped by project

Output

Based on the workspace data, here's an illustrative summary: 15 active time entries across 4 projects this week. 'Website Redesign' has 6 entries totaling 18.5 hours (3 team members). 'API Integration' shows 5 entries at 12 hours (2 members). 'Client Onboarding' has 3 entries at 7.5 hours, and 'Internal Tools' has 1 entry at 3 hours. The longest single session was 4.5 hours on the redesign project. This reflects typical workspace activity patterns when querying time-tracking data.

Notes

This example demonstrates Clockify's core read capability: aggregating time-entry data across users and projects. Requires workspace-level API access. The actual response structure depends on your workspace's project taxonomy and active timers. Rate limits apply to bulk queries spanning many users.

Prompt

@Clockify create a new client called 'Acme Industries' in our main workspace and set their hourly rate to $150

Output

Client 'Acme Industries' created successfully in workspace 'Main Operations' (ID: 64a687e29ae1f428e7ebe303). Hourly rate set to $150.00 USD. The client is now available for project assignment and time-entry tagging. You can associate existing projects with this client or create new ones under their account. Note that rate changes won't retroactively affect already-logged time entries.

Notes

This showcases Clockify's client-management action. Requires workspace admin permissions via API key. Side-effect: immediately visible to all workspace members in client dropdowns. If you later delete this client, you must first archive it and confirm no active projects or time entries reference it.

Prompt

@Clockify analyze our team's time allocation last month and identify which projects are over budget based on estimated hours

Output

Illustrative analysis of March time data: 'Website Redesign' logged 142 hours against a 120-hour estimate (18% over). 'API Integration' used 87 of 100 hours (13% under). 'Client Onboarding' hit 95 hours vs. 80 estimated (19% over). Two team members consistently exceed estimates on design tasks, suggesting scope creep or underestimation. The AI synthesized this by cross-referencing time entries with project budgets and user assignments.

Notes

This example pairs Clockify's data retrieval with AI reasoning to surface budget trends. The MCP provides raw time/project data; the AI performs the over-budget calculation and pattern recognition. Accuracy depends on whether your workspace consistently sets project estimates and tags entries correctly.

Use-case deep-dives

Client billing reconciliation at agencies

When Clockify MCP wins for monthly client invoicing

A 6-person creative agency bills 12 clients monthly and needs to pull time entries, match them to project codes, and generate invoices. The Clockify MCP is the right call here because it exposes client creation, user filtering, and webhook setup in one integration—your AI can create new clients when contracts start, query who logged hours to which project, and subscribe to time-entry events so billing alerts fire automatically. The auth is straightforward API key, so onboarding a bookkeeper takes five minutes. The threshold: if you're reconciling across multiple time-tracking tools or need sub-hour granularity that Clockify doesn't track, you'll hit limits. For single-tool agencies under 20 clients, this MCP turns a two-day billing close into a same-day run.

Standup capacity check for distributed teams

Using Clockify MCP to surface who's overloaded before standup

A 10-person engineering team runs daily standups and the PM wants a pre-meeting snapshot of who logged over 9 hours yesterday or has zero entries this week. The Clockify MCP handles this cleanly: the AI calls Find All Users On Workspace, filters by recent activity, and flags outliers in Slack 15 minutes before standup starts. The webhook tool means you can also subscribe to real-time entry events, so the system learns patterns without manual queries. The catch: Clockify's user-filtering tool is paginated and sortable, but if your workspace has 100+ users and you're querying every morning, response times creep up. For teams under 30, this is a one-prompt setup that turns time data into a standup talking point instead of a post-mortem surprise.

Onboarding manager assignment for HR teams

When Clockify MCP streamlines new-hire manager lookup

An HR coordinator at a 40-person startup onboards 3-5 people a month and needs to assign each new hire to their manager in Clockify, then notify the manager via email. The Find User's Team Managers tool makes this a single AI call: pass the new hire's user ID, get back the manager list, trigger the email. The Create Client tool also helps if each new hire maps to a billable project or department code. The limitation: if your org structure lives in BambooHR or Workday and Clockify is just the time tracker, you're duplicating manager data across systems—this MCP doesn't sync org charts. For startups where Clockify is the source of truth for team structure, this cuts onboarding admin from 20 minutes per hire to under two.

Frequently asked

What does the Clockify MCP do in Switchy?

It lets your AI agents read and manage Clockify time tracking data — create clients, filter workspace users, set up webhooks for event notifications, and find team managers. Your agents can automate time entry workflows, pull reports, and sync Clockify data with other tools in your workspace without manual exports.

Do I need admin access to connect Clockify?

You need a Clockify API key, which any user can generate from their profile settings. However, creating clients, managing webhooks, and filtering workspace users typically require workspace admin permissions in Clockify itself. Check your role before connecting if you plan to use those tools.

Can the MCP automatically track time or start timers?

No. The 19 tools focus on workspace management — clients, webhooks, user lookups — not active time tracking. If you need agents to start timers or log hours, you'll have to use Clockify's API directly or wait for Switchy to add those tools.

Why use this instead of Clockify's API?

The MCP wraps Clockify's API in natural language tools your agents can call without writing code. Instead of parsing JSON schemas and handling pagination yourself, you tell an agent "find all users on workspace X" and it handles the request. Faster for ad-hoc queries and automation.

Who on the team should connect Clockify?

Whoever manages your Clockify workspace and has an API key. If multiple people need access, each can connect their own key — Switchy doesn't share credentials. For webhook setup and client management, connect the account with admin permissions in Clockify.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.