Clockify MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Clockify MCP or direct API to log time entries, fetch project reports, create new projects, and manage timesheets through natural language.

Clockify logoClockify
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.

74 Tools

Try Clockify now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Clockify
Try asking
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

Create a project in a Clockify workspace with a name and optional color, billable status, and client association.

Create Shared Report

Create a shared summary, detailed, or weekly report with a date range and summary grouping options in a Clockify workspace.

Create Tag

Create a named tag in a Clockify workspace.

Create Task

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

Create Templates On Workspace

Create one or more templates in a Clockify workspace with associated projects and optional time entries.

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

Creates a new Clockify workspace for time tracking and project management in the specified organization.

Delete Client

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

Delete a template from a Clockify workspace using the deprecated template API.

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

Generates a detailed time-entry report with filtering and pagination for a workspace.

Generate Expense Report

Generate a detailed expense report for a workspace and date range, limited to 31 days on the free plan.

Generate New Webhook Token

Generate a new token for a workspace webhook, invalidating its previous token.

Generate Summary Report

Generate a workspace time-entry summary report grouped by projects, users, clients, or other criteria.

Generate Weekly Report

Generate a weekly workspace time-entry report with breakdowns grouped by user, project, task, or other dimensions.

Get All Addon Webhooks

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

Get All My Workspaces

Lists workspaces accessible to the authenticated user, optionally filtered by roles.

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

Retrieves created entities of a specified type in a workspace using the experimental API.

Get Currently Logged In User Info

Tool to retrieve info about the authenticated user.

Get Deleted Entities

Requests deleted entities of a specified type in a workspace through the 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

Retrieve a page of currently running time entries in a workspace to check active timers and who is tracking time.

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

Generate a shared report by ID using the Clockify Reports API.

Get Shared Reports

Retrieve the first page of shared reports for the current user in a Clockify workspace.

Get Tag By ID

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

Get Tags

List a page of workspace tags, optionally filtering by name or archived status.

Get Task

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

Get Tasks

List, search, or filter a page of tasks on a specific project in a workspace.

Get Templates On Workspace

List a page of templates in a Clockify workspace, optionally filtered by name.

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

Retrieve updated workspace entities using the experimental API for one supported type: time entries, time entry rates, time entry custom field values, or custom fields.

Get User Groups

List a page of 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

Lists a page of scheduling assignments in a workspace, starting from a specified date and optionally bounded by an end date.

Remove User From Group

Remove a user from a Clockify user group.

Stop User Timer

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

Update Client

Updates a client in a Clockify workspace, including details such as name, email, address, or archived status.

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

Update a shared report's name, public visibility, and fixed-date setting 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

Bulk updates multiple time entries for a specified user in a Clockify workspace, including start/end times, descriptions, billable status, and project or task associations.

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

Updates a workspace webhook's configuration, including its name, URL, event type, and trigger sources.

Update Workspace Hourly Rate

Tool to update the workspace billable hourly rate.

SETUP GUIDE

Connect Clockify MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["clockify"],
  mcp: true,
});
Create a session scoped to Clockify and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all users in my main workspace",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Clockify request
SETUP GUIDE

Connect Clockify API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["clockify"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Clockify
3

Run Clockify tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all users in my main workspace" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Clockify tool calls through the session, and print the final answer

Why Use Composio?

AI Native Clockify Integration

  • Supports both Clockify MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Clockify data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Clockify access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Clockify
  • Scoped, least privilege access to Clockify resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Clockify.It takes 30 seconds.

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

Start building