> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Clockify

> Connect Clockify to your Atako agents — 9 read and 7 write actions.

Let your agents track time, manage projects, clients, tags and tasks in your Clockify workspace.

## Connection

* **Authentication**: API key.

<Note>
  Go to app.clockify.me → click your profile picture (top-right) → Preferences → scroll to Advanced section → API → Generate. Copy the key. The key inherits your account permissions — no scope selection is needed.

  See [Clockify's documentation](https://app.clockify.me/user/profile).
</Note>

## Read actions (9)

| Action                   | Description                                                                                                                                                                                                                                                                                                                          |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_current_user`       | Get the authenticated user profile (id, email, defaultWorkspace). Probe action to verify credentials.                                                                                                                                                                                                                                |
| `get_project`            | Fetch a single project by ID.                                                                                                                                                                                                                                                                                                        |
| `list_clients`           | List clients on a workspace.                                                                                                                                                                                                                                                                                                         |
| `list_project_tasks`     | List tasks on a project. Arguments: page (integer, default 1), page-size (integer, default 50).                                                                                                                                                                                                                                      |
| `list_projects`          | List projects on a workspace. Arguments: archived (boolean, include archived), page (integer, default 1), page-size (integer, default 50).                                                                                                                                                                                           |
| `list_tags`              | List tags on a workspace.                                                                                                                                                                                                                                                                                                            |
| `list_user_time_entries` | List time entries for a user on a workspace. Arguments: start (ISO 8601 string, optional — filter from), end (ISO 8601 string, optional — filter to), project (project ID string, optional — filter by project), in-progress (boolean, optional — only running entries), page (integer, default 1), page-size (integer, default 50). |
| `list_users`             | List users on a workspace. Arguments: page (integer, default 1), page-size (integer, default 50).                                                                                                                                                                                                                                    |
| `list_workspaces`        | List all workspaces the key can access.                                                                                                                                                                                                                                                                                              |

## Write actions (7)

| Action              | Description                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `create_client`     | Create a client on a workspace. Arguments: name (string, required).                                                                                                                                                                                                                                                                                                                                          |
| `create_project`    | Create a project on a workspace. Arguments: name (string, required), clientId (string, optional — client ID to assign), isPublic (boolean, optional — default false), color (string, optional — hex color without #), billable (boolean, optional — default true on paid plans).                                                                                                                             |
| `create_tag`        | Create a tag on a workspace. Arguments: name (string, required).                                                                                                                                                                                                                                                                                                                                             |
| `create_task`       | Create a task on a project. Arguments: name (string, required), assigneeIds (array of user ID strings, optional — users to assign).                                                                                                                                                                                                                                                                          |
| `create_time_entry` | Create a time entry on a workspace. Arguments: start (ISO 8601 string, required — e.g. "2026-09-22T10:00:00Z"), end (ISO 8601 string, optional — omit to start a running timer), description (string, optional), projectId (string, optional — project ID), taskId (string, optional — task ID within the project), tagIds (array of tag ID strings, optional), billable (boolean, optional — default true). |
| `stop_time_entry`   | Stop the currently running timer for a user on a workspace. The end time is set to now. No body required.                                                                                                                                                                                                                                                                                                    |
| `update_time_entry` | Update a time entry. Arguments: start (ISO 8601 string, optional), end (ISO 8601 string, optional), description (string, optional), projectId (string, optional), taskId (string, optional), tagIds (array of tag ID strings, optional), billable (boolean, optional).                                                                                                                                       |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.