View as Markdown
Clockify icon

Clockify ACTION

Start Timer

Starts a running timer for a new time entry in Clockify — no end time is set. Use Stop Timer to stop it, or Update Time Entry to set an end time later. Use Log Time Entry instead if you already know both the start and end time. See the documentation, or starting for another member when User is set
  • Action
  • Writes data
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Clockify account once, then configure and run Start Timer from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "clockify-start-timer",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    clockify: { authProvisionId: "apn_xxxxxxx" },
    workspaceId: "Workspace",
    projectId: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Start Timer inputs
Property Type Description
workspaceId Workspace string
Identifier of a workspace
Required Dynamic
projectId Project string
Identifier of a project
Optional Dynamic
taskId Task string
Identifier of a task
Optional Dynamic
userId User string
Starts the timer for this workspace member instead of yourself. Leave blank to start the timer for your own account.
Optional Dynamic
start Start string
Start date and time of the timer, in ISO 8601 format. Example: 2026-08-05T09:00:00Z. Defaults to the current time if left blank.
Optional
timeEntryDescription Description string
Description of the time entry
Optional
billable Billable boolean
Whether the time entry is billable
Optional
tagIds Tags string[]
Array of tag identifiers
Optional Dynamic
timeEntryType Type string
The type of the time entry
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
clockify-start-timer
Version
0.0.2
App
Clockify
Authentication
API key
Read-only
No
Destructive
No
Open world
Yes