How to connect Clockify to Claude

Connect Claude Web, Desktop and Cowork to Clockify MCP. List all your active workspaces, add a new client to marketing workspace, and more using natural language, with authentication handled for you.

Get started for free Get a demo

Clockify

Api KeyOauth2

Clockify is a free time tracking software for individuals and teams to monitor work hours across projects. Track, manage, and report time for better productivity and transparency.

73 Tools

Managed auth

Connect Clockify without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Book a call

Explore the MCP Gateway

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Clockify account to Claude via Composio Connect, enabling it to list all your active workspaces, add a new client to marketing workspace, show all users on design team workspace, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Clockify with

Claude Code OpenAI Agents SDK Claude Agent SDK Codex OpenClaw Hermes Atomic Agent Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI Pydantic AI AutoGen

Connecting Clockify to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash

https://connect.composio.dev/mcp

Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Clockify account

Back in Claude, ask it to connect to Clockify or give it any Clockify-related task.

For example, ask Claude to:

"List all your active workspaces"
"Add a new client to marketing workspace"
"Show all users on design team workspace"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Clockify account is ready to use.

What is the Clockify Claude Connector, and what's possible with it?

The Clockify MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Clockify account. It provides structured and secure access to your team's time tracking data, so your agent can perform actions like managing clients, handling workspace users, setting up webhooks, and retrieving workspace details on your behalf.

Workspace user management: Let your agent list all users in a workspace, filter users by advanced criteria, or find team managers for more efficient team organization.
Client creation and deletion: Easily create new clients or remove existing ones from your workspace, streamlining project onboarding and cleanup.
Webhook automation: Enable your agent to create, delete, and manage webhooks for real-time notifications and integrations with other tools.
Workspace overview and navigation: Retrieve a list of all workspaces you belong to, empowering your agent to access and organize time tracking across multiple teams or projects.
Addon and webhook token management: Generate new webhook tokens and list all addon webhooks, ensuring secure and automated integrations with third-party services.

Troubleshooting

1. Why does Claude not use the Composio connector for Clockify?

The connector can show as connected, but Claude must use it in each Clockify conversation.

Click + at the lower left of the chat, or type /.
Hover Connectors.
Turn on Composio.
Ask Claude to connect to Clockify again.

2. Why does Claude show an MCP server error before Clockify connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Clockify.

Check that the connector URL is https://connect.composio.dev/mcp.
Connectors run from Anthropic's cloud, so your device network is usually not the problem.
Add the connector again from Customize > Connectors, then ask Claude to connect Clockify.
If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Clockify authorization link not work?

The Composio connector is one server. Your Clockify account connects separately when Claude asks for it.

If the browser does not open, or the link expires, ask Claude to retry the Clockify connection.
Composio creates a fresh Clockify authorization link.
Open that link in your browser and finish the Clockify sign-in.

4. Why do Clockify actions fail after they worked before?

The Clockify connection can expire or lose permission.

Ask Claude to inspect the Clockify connection.
If the connection is unhealthy, disconnect it when Claude prompts you.
Reconnect the Clockify account and retry the action.
If Claude shows a permission prompt, approve it before Claude changes data in Clockify.
If the action still fails with a permission error, check that the connected account has that permission in Clockify itself.

5. How do I switch to a different Clockify account?

Claude can manage the Clockify connection for you.

Ask Claude to disconnect or delete the current Clockify account.
Ask Claude to connect Clockify again.
Open the new Composio authorization link for Clockify.
Sign in with the other Clockify account in the browser.
After the account connects, ask Claude to retry the Clockify task.

6. Why is my Clockify connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Clockify connection works in Claude Web, Desktop, and Cowork.

In Claude Desktop, open Customize > Connectors.
Next to Composio, click ⋮ and click Clear cache.
If Clockify tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Clockify.

TOOLS

Supported Tools

Every Clockify action and event your agent gets out of the box.

Add User to Group

Tool to add a user to a user group in a Clockify workspace.

Create Client

Tool to add a new client to a workspace.

Create New Project

Tool to create a new project in a Clockify workspace.

Create Shared Report

Tool to create a shared report in Clockify.

Create Task

Tool to add a new task to a project in Clockify.

Create Templates On Workspace

Tool to create templates on a Clockify workspace.

Create Time Entry

Tool to create a new time entry in a Clockify workspace.

Create User Group

Tool to create a new user group in a workspace.

Create User Time Entry

Tool to create a time entry for another user in a Clockify workspace.

Create Webhook

Tool to create a new webhook in a workspace.

Create Workspace

Tool to create a new workspace in Clockify.

Delete Client

Permanently deletes a client from a Clockify workspace.

Delete Project

Tool to delete a project from a workspace.

Delete Shared Report

Tool to delete a shared report from a workspace by ID.

Delete Tag

Tool to delete a tag from a Clockify workspace.

Delete Task

Tool to delete a task from a project in Clockify.

Delete Template

Tool to delete a template from a Clockify workspace.

Delete Time Entry

Tool to delete a time entry from a workspace by ID.

Delete User Group

Tool to delete a user group from a workspace.

Delete User Time Entries

Tool to delete multiple time entries for a user in a workspace.

Delete Webhook

Tool to delete a webhook from a workspace.

Duplicate Time Entry

Tool to duplicate an existing time entry in a Clockify workspace.

Filter Workspace Users

Tool to filter users in a workspace by advanced criteria.

Find User's Team Managers

Retrieves the list of team managers assigned to a specific user in a Clockify workspace.

Generate Detailed Report

Tool to generate a detailed time entry report with filtering and pagination.

Generate Expense Report

Tool to generate a detailed expense report for a Clockify workspace.

Generate New Webhook Token

Tool to generate a new webhook token.

Generate Summary Report

Tool to generate a summary report for time entries in a Clockify workspace.

Generate Weekly Report

Tool to generate a weekly time entry report for a workspace with grouped data.

Get All Addon Webhooks

Tool to list all webhooks for an addon in a workspace.

Get All My Workspaces

Tool to list all workspaces the user belongs to.

Get All Webhooks

Tool to list all webhooks in a workspace.

Get Client By ID

Retrieves detailed information about a specific client in a Clockify workspace.

Get Clients

Tool to list clients in a workspace.

Get Created Entities

Tool to retrieve created entities within a workspace (Experimental).

Get Currently Logged In User Info

Tool to retrieve info about the authenticated user.

Get Deleted Entities

Tool to retrieve information about entities deleted within a date range (Experimental API).

Get Holidays

Tool to retrieve all holidays for a workspace.

Get Holidays In Period

Tool to retrieve holidays in a specific period.

Get In Progress Time Entries

Tool to retrieve all currently running time entries in a workspace.

Get member's profile

Tool to get a member's profile in a workspace.

Get Project

Tool to retrieve detailed information about a specific project by ID.

Get Projects

Tool to list projects in a workspace with filtering and pagination.

Get Shared Report

Tool to retrieve a shared report by ID from Clockify.

Get Shared Reports

Tool to retrieve all shared reports in a workspace.

Get Tag By ID

Tool to retrieve detailed information about a specific tag by ID in a Clockify workspace.

Get Tags

Tool to find and list tags in a workspace.

Get Task

Retrieves detailed information about a specific task in a Clockify project.

Get Tasks

Tool to find all tasks on a specific project in a workspace.

Get Templates On Workspace

Tool to list all templates in a workspace.

Get Time Entries

Tool to retrieve historical time entries for a user in a workspace with filters.

Get Time Entry

Tool to retrieve a specific time entry by ID from a workspace.

Get Updated Entities

Tool to retrieve entities that have been updated in a workspace (Experimental).

Get User Groups

Tool to find all user groups in a workspace.

Get Webhook By ID

Retrieves detailed information about a specific webhook in a Clockify workspace.

Get Webhook Logs

Tool to retrieve webhook logs for a specific webhook.

Get Workspace Info

Retrieves detailed information about a specific Clockify workspace.

List Assignments

Tool to retrieve all scheduling assignments in a workspace.

Remove User From Group

Tool to remove a user from a group in Clockify.

Stop User Timer

Tool to stop a currently running timer for a user in a workspace.

Update Client

Tool to update an existing client in a Clockify workspace.

Update Project

Tool to update an existing project in a Clockify workspace.

Update Project Memberships

Tool to update project memberships in Clockify.

Update Project User Hourly Rate

Tool to update a project user's billable rate.

Update Shared Report

Tool to update an existing shared report in Clockify.

Update Tag

Tool to update a tag in a Clockify workspace.

Update Task

Tool to update an existing task on a project in Clockify.

Update Time Entries

Tool to bulk update multiple time entries in a Clockify workspace.

Update Time Entry

Tool to update an existing time entry in a Clockify workspace.

Update User Group

Tool to update an existing user group in a workspace.

Update User Hourly Rate

Tool to update a user's hourly rate in a Clockify workspace.

Update Webhook

Tool to update a webhook in a workspace.

Update Workspace Hourly Rate

Tool to update the workspace billable hourly rate.

FRAMEWORKS

How to build Clockify MCP Agent with another framework

Claude Code

Use Clockify MCP with Claude Code

OpenAI Agents SDK

Use Clockify MCP with OpenAI Agents SDK

Claude Agent SDK

Use Clockify MCP with Claude Agent SDK

Codex

Use Clockify MCP with Codex

OpenClaw

Use Clockify MCP with OpenClaw

Hermes

Use Clockify MCP with Hermes

Atomic Agent

Use Clockify MCP with Atomic Agent

Google ADK

Use Clockify MCP with Google ADK

LangChain

Use Clockify MCP with LangChain

Vercel AI SDK

Use Clockify MCP with Vercel AI SDK

Mastra AI

Use Clockify MCP with Mastra AI

LlamaIndex

Use Clockify MCP with LlamaIndex

CrewAI

Use Clockify MCP with CrewAI

Pydantic AI

Use Clockify MCP with Pydantic AI

AutoGen

Use Clockify MCP with AutoGen

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Google Sheets

Oauth2

Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.

Notion

Oauth2Api Key

Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.

Airtable

Oauth2Api Key

Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.

Asana

Oauth2

Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.

FAQ

Frequently asked questions

With a standalone Clockify MCP server, the agents and LLMs can only access a fixed set of Clockify tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Clockify and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Clockify tools.

Yes, absolutely. You can configure which Clockify scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Clockify data and credentials are handled as safely as possible.

Start with Clockify.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Clockify tool your agent needs.Free to start.

Start building

How to connect Clockify to Claude

Connect Clockify without auth hassles

Introduction

Also integrate Clockify with

Connecting Clockify to Claude Web, Desktop, and Cowork

1. Add with one click

Add manually

2. Authorize in your browser

3. Connect your Clockify account

What is the Clockify Claude Connector, and what's possible with it?

Troubleshooting

1. Why does Claude not use the Composio connector for Clockify?

2. Why does Claude show an MCP server error before Clockify connects?

3. Why does the Clockify authorization link not work?

4. Why do Clockify actions fail after they worked before?

5. How do I switch to a different Clockify account?

6. Why is my Clockify connection missing in Claude Desktop or on a Team plan?

Supported Tools

How to build Clockify MCP Agent with another framework

Claude Code

OpenAI Agents SDK

Claude Agent SDK

Codex

OpenClaw

Hermes

Atomic Agent

Google ADK

LangChain

Vercel AI SDK

Mastra AI

LlamaIndex

CrewAI

Pydantic AI

AutoGen

Explore Other Toolkits

Google Sheets

Notion

Airtable

Asana

Frequently asked questions

What are the differences in Tool Router MCP and Clockify MCP?+

Can I use Tool Router MCP with Claude Cowork?+

Can I manage the permissions and scopes for Clockify while using Tool Router?+

How safe is my data with Composio Tool Router?+

Start with Clockify.It takes 30 seconds.