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.
- Tools
- 26
- What they doRead · write · destructive
- 14 · 11 · 114 read11 write1 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Clockify connection
In AgentKit > Connections, create a Clockify connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'clockify'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'clockify_current_user_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "clockify"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="clockify_current_user_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Clockify credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolclockify_client_getGet one Clockify client by ID.Read-onlyGet Client
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.
Inputs
client_idstringrequired- ID of the client. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
clockify_client_listList clients in a Clockify workspace, optionally filtered by name or archived status.Read-onlyList Clients
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.
Inputs
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
archivedboolean- Set to true for archived clients only, or false for active clients only. Example: false.
namestring- Only return clients whose name contains this text. Example: Acme.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 50 when omitted. Example: 100.
sort_columnstring- Field to sort by. Clockify sorts by NAME when omitted. Example: NAME.
sort_orderstring- Sort direction: ASCENDING or DESCENDING. Example: ASCENDING.one of
ASCENDINGDESCENDING
clockify_current_user_getGet the Clockify user that owns the connected API key.Read-onlyGet Current User
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.
Inputs
include_membershipsboolean- Set to true to also return the user's workspace and project memberships. Example: true.
clockify_project_getGet one Clockify project by ID.Read-onlyGet Project
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.
Inputs
project_idstringrequired- ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
hydratedboolean- Set to true to include extra details, such as the project's custom fields. Example: true.
clockify_project_listList projects in a Clockify workspace, optionally filtered by name, client, archived or billable status.Read-onlyList Projects
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.
Inputs
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
archivedboolean- Set to true for archived projects only, or false for active projects only. Leave empty to get both. Example: false.
billableboolean- Set to true for billable projects only, or false for non-billable only. Leave empty to get both. Example: true.
clientsarray- Only return projects that belong to any of these clients. Get client IDs from clockify_client_list. Example: ["64c2d3e4f5a6b7c8d9e0f1a2"].
hydratedboolean- Set to true to include extra details on each project, such as its custom fields and full membership data. Example: true.
namestring- Only return projects whose name contains this text (or matches it exactly when strict_name_search is true). Example: Website redesign.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 50 when omitted. Example: 100.
sort_columnstring- Field to sort by: ID, NAME, CLIENT_NAME, DURATION, BUDGET or PROGRESS. Example: NAME.one of
IDNAMECLIENT_NAMEDURATIONBUDGETPROGRESS sort_orderstring- Sort direction: ASCENDING or DESCENDING. Example: ASCENDING.one of
ASCENDINGDESCENDING strict_name_searchboolean- Set to true so name matches only projects with exactly that name. Example: true.
clockify_tag_getGet one Clockify tag by ID.Read-onlyGet Tag
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.
Inputs
tag_idstringrequired- ID of the tag. Get it from clockify_tag_list. Example: 64f5a6b7c8d9e0f1a2b3c4d5.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
clockify_tag_listList tags in a Clockify workspace, optionally filtered by name or archived status.Read-onlyList Tags
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.
Inputs
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
archivedboolean- Set to true for archived tags only, or false for active tags only. Example: false.
namestring- Only return tags whose name contains this text (or matches it exactly when strict_name_search is true). Example: meeting.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 50 when omitted. Example: 100.
sort_columnstring- Field to sort by: ID or NAME. Example: NAME.one of
IDNAME sort_orderstring- Sort direction: ASCENDING or DESCENDING. Example: ASCENDING.one of
ASCENDINGDESCENDING strict_name_searchboolean- Set to true so name matches only tags with exactly that name. Example: true.
clockify_task_getGet one task of a Clockify project by ID.Read-onlyGet Task
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.
Inputs
project_idstringrequired- ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
task_idstringrequired- ID of the task. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
clockify_task_listList the tasks of a Clockify project, optionally filtered by name or active status.Read-onlyList Tasks
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.
Inputs
project_idstringrequired- ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
is_activeboolean- Set to true for active (open) tasks only, or false for done tasks only. Example: true.
namestring- Only return tasks whose name contains this text (or matches it exactly when strict_name_search is true). Example: Design review.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 50 when omitted. Example: 100.
sort_columnstring- Field to sort by: ID or NAME. Example: NAME.one of
IDNAME sort_orderstring- Sort direction: ASCENDING or DESCENDING. Example: ASCENDING.one of
ASCENDINGDESCENDING strict_name_searchboolean- Set to true so name matches only tasks with exactly that name. Example: true.
clockify_time_entry_getGet one Clockify time entry by ID.Read-onlyGet Time Entry
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.
Inputs
time_entry_idstringrequired- ID of the time entry. Get it from clockify_time_entry_list or clockify_time_entry_list_in_progress. Example: 6501a2b3c4d5e6f7a8b9c0d1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
hydratedboolean- Set to true to return the full project, task and tag objects instead of only their IDs. Example: true.
clockify_time_entry_listList a user's time entries in a Clockify workspace, newest first, optionally filtered by date range, description, project, task or tags.Read-onlyList Time Entries
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.
Inputs
user_idstringrequired- 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_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
descriptionstring- Only return entries whose description contains this text. Example: planning.
endstring- Only return entries up to this time, in UTC as yyyy-MM-ddTHH:mm:ssZ. Example: 2026-11-30T23:59:59Z.
hydratedboolean- Set to true to return the full project, task and tag objects instead of only their IDs. Example: true.
in_progressboolean- Set to true to return only the user's running timer. Example: true.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 50 when omitted. Example: 100.
projectstring- Only return entries for this project ID (from clockify_project_list). Example: 64b1c2d3e4f5a6b7c8d9e0f1.
project_requiredboolean- Set to true to return only entries that have a project. Example: true.
startstring- Only return entries that start at or after this time, in UTC as yyyy-MM-ddTHH:mm:ssZ. Example: 2026-11-01T00:00:00Z.
tagsarray- Only return entries that have any of these tag IDs (from clockify_tag_list). Example: ["64f5a6b7c8d9e0f1a2b3c4d5"].
taskstring- Only return entries for this task ID (from clockify_task_list). Example: 64d3e4f5a6b7c8d9e0f1a2b3.
task_requiredboolean- Set to true to return only entries that have a task. Example: true.
clockify_time_entry_list_in_progressList every running timer in a Clockify workspace, across all users.Read-onlyList Running Time Entries
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.
Inputs
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 10 when omitted. Maximum 1000. Example: 100.
clockify_workspace_listList the Clockify workspaces the connected user belongs to, optionally only those where they hold given roles.Read-onlyList Workspaces
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.
Inputs
rolesstring- 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_ADMINOWNERTEAM_MANAGERPROJECT_MANAGER
clockify_workspace_user_listList the members of a Clockify workspace, optionally filtered by name, email, status or project access.Read-onlyList Workspace Users
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.
Inputs
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
emailstring- Only return users whose email address contains this text. Example: jane@example.com.
include_rolesboolean- Set to true to include each user's manager roles (the projects and members they manage). Defaults to false. Example: true.default
false membershipsstring- Include each user's memberships of this kind: ALL, NONE, WORKSPACE, PROJECT or USERGROUP. Clockify uses NONE when omitted. Example: WORKSPACE.one of
ALLNONEWORKSPACEPROJECTUSERGROUP namestring- Only return users whose name contains this text. Example: Jane.
pageinteger- Page number to return, starting at 1. Clockify returns 1 when omitted. Example: 2.
page_sizeinteger- Number of items per page. Clockify uses 50 when omitted. Example: 100.
project_idstring- Only return users who have access to this project. Get the ID from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
sort_columnstring- Field to sort by: ID, EMAIL, NAME, NAME_LOWERCASE, ACCESS, HOURLYRATE or COSTRATE. Clockify sorts by EMAIL when omitted. Example: NAME.one of
IDEMAILNAMENAME_LOWERCASEACCESSHOURLYRATECOSTRATE sort_orderstring- Sort direction: ASCENDING or DESCENDING. Example: ASCENDING.one of
ASCENDINGDESCENDING statusstring- Only return users with this workspace membership status: PENDING, ACTIVE, DECLINED, INACTIVE or ALL. Example: ACTIVE.one of
PENDINGACTIVEDECLINEDINACTIVEALL
clockify_client_createCreate a client in a Clockify workspace.WriteCreate Client
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.
Inputs
namestringrequired- Name of the new client, up to 100 characters. Example: Acme Corp.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
addressstring- Client postal address, up to 3,000 characters. Example: 1 Main St, Springfield.
emailstring- Client contact email address. Example: billing@acme.com.
notestring- Free-text note about the client, up to 3,000 characters. Example: Net 30 payment terms.
clockify_client_updateUpdate a Clockify client's name, email, address or note, or archive it.WriteUpdate Client
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.
- Idempotent
Inputs
client_idstringrequired- ID of the client. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
addressstring- Client postal address, up to 3,000 characters. Example: 1 Main St, Springfield.
archivedboolean- Set to true to archive the client or false to restore it. Example: true.
emailstring- Client contact email address. Example: billing@acme.com.
namestring- New client name, up to 100 characters. Example: Acme Corporation.
notestring- Free-text note about the client, up to 3,000 characters. Example: Net 30 payment terms.
clockify_project_createCreate a project in a Clockify workspace, optionally linked to a client.WriteCreate Project
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.
Inputs
namestringrequired- Name of the new project, up to 250 characters. Example: Website redesign.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
billableboolean- Whether time on this project is billable by default. Example: true.
client_idstring- ID of the client the project is for. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
colorstring- Project color as a # followed by six hex digits. Example: #03A9F4.
is_publicboolean- 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.
notestring- Free-text note about the project, up to 16,384 characters. Example: Q4 marketing site rebuild.
clockify_project_updateUpdate a Clockify project's name, client, color, billable or public setting, note, or archive it.WriteUpdate Project
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.
- Idempotent
Inputs
project_idstringrequired- ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
archivedboolean- Set to true to archive the project or false to restore it. Example: true.
billableboolean- Whether time on this project is billable by default. Example: true.
client_idstring- ID of the client the project is for. Get it from clockify_client_list. Example: 64c2d3e4f5a6b7c8d9e0f1a2.
colorstring- Project color as a # followed by six hex digits. Example: #03A9F4.
is_publicboolean- 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.
namestring- New project name, up to 250 characters. Example: Website redesign (phase 2).
notestring- Free-text note about the project, up to 16,384 characters. Example: Q4 marketing site rebuild.
clockify_tag_createCreate a tag in a Clockify workspace.WriteCreate Tag
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.
Inputs
namestringrequired- Name of the new tag, up to 100 characters. Example: meeting.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
clockify_tag_updateRename a Clockify tag or archive it.WriteUpdate Tag
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.
- Idempotent
Inputs
tag_idstringrequired- ID of the tag. Get it from clockify_tag_list. Example: 64f5a6b7c8d9e0f1a2b3c4d5.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
archivedboolean- Set to true to archive the tag or false to restore it. Example: true.
namestring- New tag name, up to 100 characters. Example: client meeting.
clockify_task_createCreate a task in a Clockify project, optionally with assignees and a time estimate.WriteCreate Task
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.
Inputs
namestringrequired- Name of the new task, up to 1,000 characters. Example: Design review.
project_idstringrequired- ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
assignee_idsarray- User IDs of the workspace members assigned to the task. Get them from clockify_workspace_user_list. Example: ["64e4f5a6b7c8d9e0f1a2b3c4"].
estimatestring- Time estimate for the task as an ISO 8601 duration. Example: PT2H30M (2 hours 30 minutes).
statusstring- Task status: ACTIVE (open) or DONE. Example: ACTIVE.one of
ACTIVEDONE
clockify_task_updateUpdate a task in a Clockify project: rename it, change assignees, estimate or billable flag, or mark it ACTIVE or DONE.WriteUpdate Task
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.
- Idempotent
Inputs
namestringrequired- 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_idstringrequired- ID of the project. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
task_idstringrequired- ID of the task. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
assignee_idsarray- User IDs of the workspace members assigned to the task. Get them from clockify_workspace_user_list. Example: ["64e4f5a6b7c8d9e0f1a2b3c4"].
billableboolean- Whether time on this task is billable. Example: true.
estimatestring- Time estimate for the task as an ISO 8601 duration. Example: PT2H30M (2 hours 30 minutes).
statusstring- Task status: ACTIVE (open) or DONE. Example: ACTIVE.one of
ACTIVEDONE
clockify_time_entry_createCreate 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.WriteCreate Time Entry
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.
Inputs
startstringrequired- When the entry starts, in UTC as yyyy-MM-ddTHH:mm:ssZ. Example: 2026-11-14T09:00:00Z.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
billableboolean- Whether the time is billable. When omitted Clockify uses the project's default. Example: true.
descriptionstring- What the time was spent on, up to 3,000 characters. Example: Sprint planning meeting.
endstring- 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_idstring- ID of the project to log the time against. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
tag_idsarray- IDs of tags to put on the entry. Get them from clockify_tag_list. Example: ["64f5a6b7c8d9e0f1a2b3c4d5"].
task_idstring- ID of a task in that project. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
typestring- Entry type: REGULAR for work time or BREAK for a break. Clockify uses REGULAR when omitted. Example: REGULAR.one of
REGULARBREAK
clockify_time_entry_stopStop a user's running timer in a Clockify workspace by setting its end time.WriteStop Timer
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).
Inputs
endstringrequired- When the timer stops, in UTC as yyyy-MM-ddTHH:mm:ssZ; usually the current time. Example: 2026-11-14T10:30:00Z.
user_idstringrequired- 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_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
clockify_time_entry_updateReplace a Clockify time entry's start, end, description, project, task, tags, billable flag or type.WriteUpdate Time Entry
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.
- Idempotent
Inputs
startstringrequired- 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_idstringrequired- ID of the time entry. Get it from clockify_time_entry_list or clockify_time_entry_list_in_progress. Example: 6501a2b3c4d5e6f7a8b9c0d1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
billableboolean- Whether the time is billable. When omitted Clockify uses the project's default. Example: true.
descriptionstring- What the time was spent on, up to 3,000 characters. Example: Sprint planning meeting.
endstring- 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_idstring- ID of the project to log the time against. Get it from clockify_project_list. Example: 64b1c2d3e4f5a6b7c8d9e0f1.
tag_idsarray- IDs of tags to put on the entry. Get them from clockify_tag_list. Example: ["64f5a6b7c8d9e0f1a2b3c4d5"].
task_idstring- ID of a task in that project. Get it from clockify_task_list. Example: 64d3e4f5a6b7c8d9e0f1a2b3.
typestring- Entry type: REGULAR for work time or BREAK for a break. Clockify uses REGULAR when omitted. Example: REGULAR.one of
REGULARBREAK
clockify_time_entry_deletePermanently delete one Clockify time entry.DestructiveDelete Time Entry
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.
- Idempotent
Inputs
time_entry_idstringrequired- ID of the time entry. Get it from clockify_time_entry_list or clockify_time_entry_list_in_progress. Example: 6501a2b3c4d5e6f7a8b9c0d1.
workspace_idstringrequired- ID of the Clockify workspace. Get it from clockify_workspace_list, or use activeWorkspace / defaultWorkspace from clockify_current_user_get. Example: 64a687e29ae1f428e7ebe303.
No tools match.