> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Clockify

The Clockify connector lets your AI agent act in each user's Clockify account. Each user connects their own Clockify API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 26 tools.

**Authentication:** API Key
**Categories:** Productivity, Project Management
**Tools:** 26: 14 read, 11 write, 1 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=CLOCKIFY)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Clockify connection

   In **AgentKit > Connections**, create a Clockify connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'clockify'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Clockify:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'clockify_current_user_get',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "clockify"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Clockify:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="clockify_current_user_get",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Clockify credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'clockify_client_get',
  toolInput: {
    client_id: '<client_id>',
    workspace_id: '<workspace_id>',
  },
  connector: 'clockify',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="clockify_client_get",
    tool_input={
        "client_id": "<client_id>",
        "workspace_id": "<workspace_id>",
    },
    connection_name="clockify",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `clockify_client_get`

Get Client · Read-only

Get one Clockify client by ID.
Returns the client's id, name, email, address, note, archived and currencyId.
Use this when you have a client ID. Use clockify_client_list to find clients by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`string`, required): ID of the client. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.

Example input: `{"client_id":"<client_id>","workspace_id":"<workspace_id>"}`

### `clockify_client_list`

List Clients · Read-only

List clients in a Clockify workspace, optionally filtered by name or archived status.
Returns an array of clients with id, name, email, address, note, archived and currencyId.
Use this to find a client ID. Use clockify_client_get when you already have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `archived` (`boolean`, optional): Set to true for archived clients only, or false for active clients only. Example: false.
- `name` (`string`, optional): Only return clients whose name contains this text. Example: Acme.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 50 when omitted. Example: 100.
- `sort_column` (`string`, optional): Field to sort by. Clockify sorts by NAME when omitted. Example: NAME.
- `sort_order` (`string`, optional): Sort direction: ASCENDING or DESCENDING. Example: ASCENDING. One of: `ASCENDING`, `DESCENDING`.

Example input: `{"workspace_id":"<workspace_id>"}`

### `clockify_current_user_get`

Get Current User · Read-only

Get the Clockify user that owns the connected API key.
Returns the user's id, name, email, activeWorkspace, defaultWorkspace, status and settings (time zone, week start, date format).
Use this first to find your own user ID (needed by clockify_time_entry_list and clockify_time_entry_stop) and your active workspace ID. Use clockify_workspace_user_list to look up other people.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `include_memberships` (`boolean`, optional): Set to true to also return the user's workspace and project memberships. Example: true.

Example input: `{}`

### `clockify_project_get`

Get Project · Read-only

Get one Clockify project by ID.
Returns the project's id, name, clientId, color, billable, archived, public, note, hourlyRate, costRate, estimate, budgetEstimate and memberships.
Use this when you have a project ID. Use clockify_project_list to find projects by name or client.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `hydrated` (`boolean`, optional): Set to true to include extra details, such as the project's custom fields. Example: true.

Example input: `{"project_id":"<project_id>","workspace_id":"<workspace_id>"}`

### `clockify_project_list`

List Projects · Read-only

List projects in a Clockify workspace, optionally filtered by name, client, archived or billable status.
Returns an array of projects with id, name, clientId, clientName, color, billable, archived, public, hourlyRate, estimate and memberships.
Use this to find a project ID or browse projects. Use clockify_project_get for one project's full details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `archived` (`boolean`, optional): Set to true for archived projects only, or false for active projects only. Leave empty to get both. Example: false.
- `billable` (`boolean`, optional): Set to true for billable projects only, or false for non-billable only. Leave empty to get both. Example: true.
- `clients` (`array`, optional): Only return projects that belong to any of these clients. Get client IDs from clockify_client_list. Example: ["64c2d3e4f5a6b7c8d9e0f1a2"].
- `hydrated` (`boolean`, optional): Set to true to include extra details on each project, such as its custom fields and full membership data. Example: true.
- `name` (`string`, optional): Only return projects whose name contains this text (or matches it exactly when strict_name_search is true). Example: Website redesign.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 50 when omitted. Example: 100.
- `sort_column` (`string`, optional): Field to sort by: ID, NAME, CLIENT_NAME, DURATION, BUDGET or PROGRESS. Example: NAME. One of: `ID`, `NAME`, `CLIENT_NAME`, `DURATION`, `BUDGET`, `PROGRESS`.
- `sort_order` (`string`, optional): Sort direction: ASCENDING or DESCENDING. Example: ASCENDING. One of: `ASCENDING`, `DESCENDING`.
- `strict_name_search` (`boolean`, optional): Set to true so name matches only projects with exactly that name. Example: true.

Example input: `{"workspace_id":"<workspace_id>"}`

### `clockify_tag_get`

Get Tag · Read-only

Get one Clockify tag by ID.
Returns the tag's id, name, workspaceId and archived flag.
Use this when you have a tag ID. Use clockify_tag_list to find tags by name.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tag_id` (`string`, required): ID of the tag. Get it from clockify_tag_list. Example: 64f5a6b7c8d9e0f1a2b3c4d5.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.

Example input: `{"tag_id":"<tag_id>","workspace_id":"<workspace_id>"}`

### `clockify_tag_list`

List Tags · Read-only

List tags in a Clockify workspace, optionally filtered by name or archived status.
Returns an array of tags with id, name, workspaceId and archived.
Use this to find tag IDs to put on time entries. Use clockify_tag_get when you already have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `archived` (`boolean`, optional): Set to true for archived tags only, or false for active tags only. Example: false.
- `name` (`string`, optional): Only return tags whose name contains this text (or matches it exactly when strict_name_search is true). Example: meeting.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 50 when omitted. Example: 100.
- `sort_column` (`string`, optional): Field to sort by: ID or NAME. Example: NAME. One of: `ID`, `NAME`.
- `sort_order` (`string`, optional): Sort direction: ASCENDING or DESCENDING. Example: ASCENDING. One of: `ASCENDING`, `DESCENDING`.
- `strict_name_search` (`boolean`, optional): Set to true so name matches only tags with exactly that name. Example: true.

Example input: `{"workspace_id":"<workspace_id>"}`

### `clockify_task_get`

Get Task · Read-only

Get one task of a Clockify project by ID.
Returns the task's id, name, projectId, assigneeIds, estimate, status, billable, duration and rates.
Use this when you have a task ID. Use clockify_task_list to find tasks in a project.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `task_id` (`string`, required): ID of the task. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.

Example input: `{"project_id":"<project_id>","task_id":"<task_id>","workspace_id":"<workspace_id>"}`

### `clockify_task_list`

List Tasks · Read-only

List the tasks of a Clockify project, optionally filtered by name or active status.
Returns an array of tasks with id, name, projectId, assigneeIds, estimate, status, billable and duration.
Use this to find a task ID for a time entry. Use clockify_task_get when you already have the ID.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `is_active` (`boolean`, optional): Set to true for active (open) tasks only, or false for done tasks only. Example: true.
- `name` (`string`, optional): Only return tasks whose name contains this text (or matches it exactly when strict_name_search is true). Example: Design review.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 50 when omitted. Example: 100.
- `sort_column` (`string`, optional): Field to sort by: ID or NAME. Example: NAME. One of: `ID`, `NAME`.
- `sort_order` (`string`, optional): Sort direction: ASCENDING or DESCENDING. Example: ASCENDING. One of: `ASCENDING`, `DESCENDING`.
- `strict_name_search` (`boolean`, optional): Set to true so name matches only tasks with exactly that name. Example: true.

Example input: `{"project_id":"<project_id>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_get`

Get Time Entry · Read-only

Get one Clockify time entry by ID.
Returns the entry's id, description, userId, projectId, taskId, tagIds, billable, type and timeInterval (start, end, duration).
Use this when you have an entry ID, for example before clockify_time_entry_update. Use clockify_time_entry_list to find entries.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `time_entry_id` (`string`, required): ID of the time entry. Get it from clockify_time_entry_list or clockify_time_entry_list_in_progress. Example: 6501a2b3c4d5e6f7a8b9c0d1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `hydrated` (`boolean`, optional): Set to true to return the full project, task and tag objects instead of only their IDs. Example: true.

Example input: `{"time_entry_id":"<time_entry_id>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_list`

List Time Entries · Read-only

List a user's time entries in a Clockify workspace, newest first, optionally filtered by date range, description, project, task or tags.
Returns an array of time entries with id, description, projectId, taskId, tagIds, billable, userId and timeInterval (start, end, ISO 8601 duration).
Use this to review logged time. Use clockify_time_entry_list_in_progress for timers running across the workspace and clockify_time_entry_get for one entry.
Get the user ID from clockify_current_user_get first.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `user_id` (`string`, required): ID of the user whose time entries to list. Use id from clockify_current_user_get for yourself, or a member ID from clockify_workspace_user_list (other users need admin rights). Example: 64e4f5a6b7c8d9e0f1a2b3c4.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `description` (`string`, optional): Only return entries whose description contains this text. Example: planning.
- `end` (`string`, optional): Only return entries up to this time, in UTC as yyyy-MM-ddTHH:mm:ssZ. Example: 2026-11-30T23:59:59Z.
- `hydrated` (`boolean`, optional): Set to true to return the full project, task and tag objects instead of only their IDs. Example: true.
- `in_progress` (`boolean`, optional): Set to true to return only the user's running timer. Example: true.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 50 when omitted. Example: 100.
- `project` (`string`, optional): Only return entries for this project ID (from clockify_project_list). Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `project_required` (`boolean`, optional): Set to true to return only entries that have a project. Example: true.
- `start` (`string`, optional): Only return entries that start at or after this time, in UTC as yyyy-MM-ddTHH:mm:ssZ. Example: 2026-11-01T00:00:00Z.
- `tags` (`array`, optional): Only return entries that have any of these tag IDs (from clockify_tag_list). Example: ["64f5a6b7c8d9e0f1a2b3c4d5"].
- `task` (`string`, optional): Only return entries for this task ID (from clockify_task_list). Example: 64d3e4f5a6b7c8d9e0f1a2b3.
- `task_required` (`boolean`, optional): Set to true to return only entries that have a task. Example: true.

Example input: `{"user_id":"<user_id>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_list_in_progress`

List Running Time Entries · Read-only

List every running timer in a Clockify workspace, across all users.
Returns an array of in-progress time entries with id, userId, description, projectId, taskId, tagIds and timeInterval.start.
Use this to see who is tracking time right now. Use clockify_time_entry_list for one user's history. Usually needs admin rights.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 10 when omitted. Maximum 1000. Example: 100.

Example input: `{"workspace_id":"<workspace_id>"}`

### `clockify_workspace_list`

List Workspaces · Read-only

List the Clockify workspaces the connected user belongs to, optionally only those where they hold given roles.
Returns an array of workspaces with id, name, hourlyRate, memberships, workspaceSettings and features.
Use this to find a workspace ID; almost every other Clockify tool needs one.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `roles` (`string`, optional): Only return workspaces where the user has this role: WORKSPACE_ADMIN, OWNER, TEAM_MANAGER or PROJECT_MANAGER. Owners are not counted as admins. Example: OWNER. One of: `WORKSPACE_ADMIN`, `OWNER`, `TEAM_MANAGER`, `PROJECT_MANAGER`.

Example input: `{}`

### `clockify_workspace_user_list`

List Workspace Users · Read-only

List the members of a Clockify workspace, optionally filtered by name, email, status or project access.
Returns an array of users with id, name, email, status, profilePicture and settings; with memberships set, also their workspace, project or group memberships.
Use this to find another member's user ID. Use clockify_current_user_get for the connected user.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `email` (`string`, optional): Only return users whose email address contains this text. Example: jane@example.com.
- `include_roles` (`boolean`, optional): Set to true to include each user's manager roles (the projects and members they manage). Defaults to false. Example: true. Default: `false`.
- `memberships` (`string`, optional): Include each user's memberships of this kind: ALL, NONE, WORKSPACE, PROJECT or USERGROUP. Clockify uses NONE when omitted. Example: WORKSPACE. One of: `ALL`, `NONE`, `WORKSPACE`, `PROJECT`, `USERGROUP`.
- `name` (`string`, optional): Only return users whose name contains this text. Example: Jane.
- `page` (`integer`, optional): Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
- `page_size` (`integer`, optional): Number of items per page. Clockify uses 50 when omitted. Example: 100.
- `project_id` (`string`, optional): Only return users who have access to this project. Get the ID from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `sort_column` (`string`, optional): Field to sort by: ID, EMAIL, NAME, NAME_LOWERCASE, ACCESS, HOURLYRATE or COSTRATE. Clockify sorts by EMAIL when omitted. Example: NAME. One of: `ID`, `EMAIL`, `NAME`, `NAME_LOWERCASE`, `ACCESS`, `HOURLYRATE`, `COSTRATE`.
- `sort_order` (`string`, optional): Sort direction: ASCENDING or DESCENDING. Example: ASCENDING. One of: `ASCENDING`, `DESCENDING`.
- `status` (`string`, optional): Only return users with this workspace membership status: PENDING, ACTIVE, DECLINED, INACTIVE or ALL. Example: ACTIVE. One of: `PENDING`, `ACTIVE`, `DECLINED`, `INACTIVE`, `ALL`.

Example input: `{"workspace_id":"<workspace_id>"}`

### `clockify_client_create`

Create Client · Write

Create a client in a Clockify workspace.
Returns the created client with its id, name, email, address and note.
Use this to add a client before linking projects to it. Use clockify_client_update to change an existing client.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new client, up to 100 characters. Example: Acme Corp.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `address` (`string`, optional): Client postal address, up to 3,000 characters. Example: 1 Main St, Springfield.
- `email` (`string`, optional): Client contact email address. Example: billing@acme.com.
- `note` (`string`, optional): Free-text note about the client, up to 3,000 characters. Example: Net 30 payment terms.

Example input: `{"name":"<name>","workspace_id":"<workspace_id>"}`

### `clockify_client_update`

Update Client · Write

Update a Clockify client's name, email, address or note, or archive it. Only the fields you set are sent.
Returns the updated client.
Use this to change or archive a client. Use clockify_client_create for a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `client_id` (`string`, required): ID of the client. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `address` (`string`, optional): Client postal address, up to 3,000 characters. Example: 1 Main St, Springfield.
- `archived` (`boolean`, optional): Set to true to archive the client or false to restore it. Example: true.
- `email` (`string`, optional): Client contact email address. Example: billing@acme.com.
- `name` (`string`, optional): New client name, up to 100 characters. Example: Acme Corporation.
- `note` (`string`, optional): Free-text note about the client, up to 3,000 characters. Example: Net 30 payment terms.

Example input: `{"client_id":"<client_id>","workspace_id":"<workspace_id>"}`

### `clockify_project_create`

Create Project · Write

Create a project in a Clockify workspace, optionally linked to a client.
Returns the created project with its id, name, clientId, color, billable and public settings.
Use this to add a new project. Use clockify_project_update to change or archive an existing one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new project, up to 250 characters. Example: Website redesign.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `billable` (`boolean`, optional): Whether time on this project is billable by default. Example: true.
- `client_id` (`string`, optional): ID of the client the project is for. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
- `color` (`string`, optional): Project color as a # followed by six hex digits. Example: #03A9F4.
- `is_public` (`boolean`, optional): Whether every workspace member can see and track time on the project. Making a project private needs a paid (Basic or higher) plan. Example: true.
- `note` (`string`, optional): Free-text note about the project, up to 16,384 characters. Example: Q4 marketing site rebuild.

Example input: `{"name":"<name>","workspace_id":"<workspace_id>"}`

### `clockify_project_update`

Update Project · Write

Update a Clockify project's name, client, color, billable or public setting, note, or archive it. Only the fields you set are sent.
Returns the updated project.
Use this to change or archive a project. Use clockify_project_create for a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `project_id` (`string`, required): ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `archived` (`boolean`, optional): Set to true to archive the project or false to restore it. Example: true.
- `billable` (`boolean`, optional): Whether time on this project is billable by default. Example: true.
- `client_id` (`string`, optional): ID of the client the project is for. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
- `color` (`string`, optional): Project color as a # followed by six hex digits. Example: #03A9F4.
- `is_public` (`boolean`, optional): Whether every workspace member can see and track time on the project. Making a project private needs a paid (Basic or higher) plan. Example: true.
- `name` (`string`, optional): New project name, up to 250 characters. Example: Website redesign (phase 2).
- `note` (`string`, optional): Free-text note about the project, up to 16,384 characters. Example: Q4 marketing site rebuild.

Example input: `{"project_id":"<project_id>","workspace_id":"<workspace_id>"}`

### `clockify_tag_create`

Create Tag · Write

Create a tag in a Clockify workspace.
Returns the created tag with its id, name and archived flag.
Use this to add a tag before applying it to time entries. Use clockify_tag_update to rename or archive one.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new tag, up to 100 characters. Example: meeting.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.

Example input: `{"name":"<name>","workspace_id":"<workspace_id>"}`

### `clockify_tag_update`

Update Tag · Write

Rename a Clockify tag or archive it. Only the fields you set are sent.
Returns the updated tag.
Use this to change or archive a tag. Use clockify_tag_create for a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `tag_id` (`string`, required): ID of the tag. Get it from clockify_tag_list. Example: 64f5a6b7c8d9e0f1a2b3c4d5.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `archived` (`boolean`, optional): Set to true to archive the tag or false to restore it. Example: true.
- `name` (`string`, optional): New tag name, up to 100 characters. Example: client meeting.

Example input: `{"tag_id":"<tag_id>","workspace_id":"<workspace_id>"}`

### `clockify_task_create`

Create Task · Write

Create a task in a Clockify project, optionally with assignees and a time estimate.
Returns the created task with its id, name, projectId, assigneeIds, estimate and status.
Use this to add a task. Use clockify_task_update to rename, reassign or mark a task done.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `name` (`string`, required): Name of the new task, up to 1,000 characters. Example: Design review.
- `project_id` (`string`, required): ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `assignee_ids` (`array`, optional): User IDs of the workspace members assigned to the task. Get them from clockify_workspace_user_list. Example: ["64e4f5a6b7c8d9e0f1a2b3c4"].
- `estimate` (`string`, optional): Time estimate for the task as an ISO 8601 duration. Example: PT2H30M (2 hours 30 minutes).
- `status` (`string`, optional): Task status: ACTIVE (open) or DONE. Example: ACTIVE. One of: `ACTIVE`, `DONE`.

Example input: `{"name":"<name>","project_id":"<project_id>","workspace_id":"<workspace_id>"}`

### `clockify_task_update`

Update Task · Write

Update a task in a Clockify project: rename it, change assignees, estimate or billable flag, or mark it ACTIVE or DONE. The name is always required, even if unchanged.
Returns the updated task.
Use this to change or close a task. Use clockify_task_create for a new one.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `name` (`string`, required): Task name, up to 1,000 characters. Required by Clockify on every update; pass the current name (from clockify_task_get) to keep it. Example: Design review.
- `project_id` (`string`, required): ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `task_id` (`string`, required): ID of the task. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `assignee_ids` (`array`, optional): User IDs of the workspace members assigned to the task. Get them from clockify_workspace_user_list. Example: ["64e4f5a6b7c8d9e0f1a2b3c4"].
- `billable` (`boolean`, optional): Whether time on this task is billable. Example: true.
- `estimate` (`string`, optional): Time estimate for the task as an ISO 8601 duration. Example: PT2H30M (2 hours 30 minutes).
- `status` (`string`, optional): Task status: ACTIVE (open) or DONE. Example: ACTIVE. One of: `ACTIVE`, `DONE`.

Example input: `{"name":"<name>","project_id":"<project_id>","task_id":"<task_id>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_create`

Create Time Entry · Write

Create a time entry for the connected user in a Clockify workspace: a finished entry when end is set, or a running timer when end is empty.
Returns the created entry with its id, description, projectId, taskId, tagIds, billable and timeInterval.
Use this to log time or start a timer. Use clockify_time_entry_stop to stop a running timer and clockify_time_entry_update to change an entry.
Workspaces that require custom fields, a project, task or tag on entries reject entries without them.

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `start` (`string`, required): When the entry starts, in UTC as yyyy-MM-ddTHH:mm:ssZ. Example: 2026-11-14T09:00:00Z.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `billable` (`boolean`, optional): Whether the time is billable. When omitted Clockify uses the project's default. Example: true.
- `description` (`string`, optional): What the time was spent on, up to 3,000 characters. Example: Sprint planning meeting.
- `end` (`string`, optional): When the entry ends, in UTC as yyyy-MM-ddTHH:mm:ssZ. Leave empty to leave a running timer. Example: 2026-11-14T10:30:00Z.
- `project_id` (`string`, optional): ID of the project to log the time against. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `tag_ids` (`array`, optional): IDs of tags to put on the entry. Get them from clockify_tag_list. Example: ["64f5a6b7c8d9e0f1a2b3c4d5"].
- `task_id` (`string`, optional): ID of a task in that project. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
- `type` (`string`, optional): Entry type: REGULAR for work time or BREAK for a break. Clockify uses REGULAR when omitted. Example: REGULAR. One of: `REGULAR`, `BREAK`.

Example input: `{"start":"<start>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_stop`

Stop Timer · Write

Stop a user's running timer in a Clockify workspace by setting its end time.
Returns the stopped time entry with its final timeInterval (start, end, duration).
Use this to stop the timer started by clockify_time_entry_create. Fails if the user has no running timer; check with clockify_time_entry_list (in_progress true).

Read only: no. Destructive: no. Idempotent (safe to retry): no.

Inputs:

- `end` (`string`, required): When the timer stops, in UTC as yyyy-MM-ddTHH:mm:ssZ; usually the current time. Example: 2026-11-14T10:30:00Z.
- `user_id` (`string`, required): ID of the user whose timer to stop. Use id from clockify_current_user_get for yourself, or a member ID from clockify_workspace_user_list (other users need admin rights). Example: 64e4f5a6b7c8d9e0f1a2b3c4.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.

Example input: `{"end":"<end>","user_id":"<user_id>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_update`

Update Time Entry · Write

Replace a Clockify time entry's start, end, description, project, task, tags, billable flag or type.
Returns the updated time entry.
Use this to correct an entry. Clockify replaces the entry, so fields you leave empty can be cleared: read it first with clockify_time_entry_get and pass every value you want to keep. Use clockify_time_entry_stop only to stop a running timer.

Read only: no. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `start` (`string`, required): Start time in UTC as yyyy-MM-ddTHH:mm:ssZ. Required on every update; pass the current start to keep it. Example: 2026-11-14T09:00:00Z.
- `time_entry_id` (`string`, required): ID of the time entry. Get it from clockify_time_entry_list or clockify_time_entry_list_in_progress. Example: 6501a2b3c4d5e6f7a8b9c0d1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
- `billable` (`boolean`, optional): Whether the time is billable. When omitted Clockify uses the project's default. Example: true.
- `description` (`string`, optional): What the time was spent on, up to 3,000 characters. Example: Sprint planning meeting.
- `end` (`string`, optional): When the entry ends, in UTC as yyyy-MM-ddTHH:mm:ssZ. Leave empty to leave a running timer. Example: 2026-11-14T10:30:00Z.
- `project_id` (`string`, optional): ID of the project to log the time against. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
- `tag_ids` (`array`, optional): IDs of tags to put on the entry. Get them from clockify_tag_list. Example: ["64f5a6b7c8d9e0f1a2b3c4d5"].
- `task_id` (`string`, optional): ID of a task in that project. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
- `type` (`string`, optional): Entry type: REGULAR for work time or BREAK for a break. Clockify uses REGULAR when omitted. Example: REGULAR. One of: `REGULAR`, `BREAK`.

Example input: `{"start":"<start>","time_entry_id":"<time_entry_id>","workspace_id":"<workspace_id>"}`

### `clockify_time_entry_delete`

Delete Time Entry · Destructive

Permanently delete one Clockify time entry.
Returns an empty response on success.
Use this only to remove an entry logged by mistake. Use clockify_time_entry_update to correct an entry instead.

Read only: no. Destructive: yes. Idempotent (safe to retry): yes.

Inputs:

- `time_entry_id` (`string`, required): ID of the time entry. Get it from clockify_time_entry_list or clockify_time_entry_list_in_progress. Example: 6501a2b3c4d5e6f7a8b9c0d1.
- `workspace_id` (`string`, required): ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.

Example input: `{"time_entry_id":"<time_entry_id>","workspace_id":"<workspace_id>"}`

## Related

Other Productivity connectors ([all 203](/agentkit/connectors/?category=productivity)):

- [Slack](/agentkit/connectors/slack/): Scalekit connector, OAuth, 96 tools
- [Notion](/agentkit/connectors/notion/): Scalekit connector, OAuth, 51 tools
- [Google Workspace (DWD)](/agentkit/connectors/googledwd/): Scalekit connector, Service account, 100 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
