Clockify Automation

Clockify Automation

Automate your Clockify time tracking operations directly from Claude Code. Log time entries, query historical data, manage workspaces, and audit team activity -- all without leaving your terminal.

Toolkit docs: composio.dev/toolkits/clockify

Setup

1. Add the Composio MCP server to your Claude Code config with URL: http://localhost:8787/mcp
2. When prompted, authenticate your Clockify account through the connection link provided
3. Start automating your time tracking workflows with natural language

Core Workflows

1. Create Time Entries

Log time with project, task, and tag associations, plus billable status.

Tool: CLOCKIFY_CREATE_TIME_ENTRY

Log 2 hours of work on project 64a687e2 in workspace 64a687e3 starting at 9am UTC today with description "API development"

Key parameters:

• workspaceId (required) -- workspace where the entry is created
• start (required) -- ISO 8601 start time (e.g., 2026-02-11T09:00:00Z)
• end -- ISO 8601 end time; omit to create a running timer
• projectId -- associate with a project
• taskId -- associate with a task
• description -- work description (0-3000 chars)
• tagIds -- array of tag IDs
• billable -- whether the entry is billable
• customFieldValues -- array of custom field entries with customFieldId and value

2. Query Time Entries

Retrieve historical time entries for reporting, auditing, and invoicing.

Tool: CLOCKIFY_GET_TIME_ENTRIES

Get all time entries for user abc123 in workspace xyz789 from January 2026

Key parameters:

• workspaceId (required) -- workspace to query
• userId (required) -- user whose entries to retrieve
• start / end -- ISO 8601 date range filters
• project -- filter by project ID
• task -- filter by task ID
• tags -- comma-separated tag IDs
• description -- text filter (partial match)
• hydrated -- set true to get full project/task/tag objects instead of just IDs
• in-progress -- set true to return only the running timer
• page / page-size -- pagination (default 50 per page)

3. Delete Time Entries

Remove erroneous, duplicate, or cancelled time entries.

Tool: CLOCKIFY_DELETE_TIME_ENTRY

Delete time entry 5b715448 from workspace 64a687e3

• Requires workspaceId and id (the time entry ID)
• Use for cleanup of bad imports or duplicates

4. Manage Workspaces

List all workspaces the authenticated user belongs to.

Tool: CLOCKIFY_GET_ALL_MY_WORKSPACES

Show me all my Clockify workspaces

• Optional roles filter -- array of roles like ["WORKSPACE_ADMIN", "OWNER"]
• Use this to discover workspace IDs before creating or querying entries

5. User Information

Retrieve current user details and list workspace members.

Tools: CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO, CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE

Who am I logged in as? Then list all users in workspace 64a687e3

• CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO returns the authenticated user's profile (no parameters needed)
• CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE requires workspaceId; supports name, email filters and pagination (page, page-size max 100)

6. Running Timer Management

Start a timer by omitting end in create, or check for running entries.

Tools: CLOCKIFY_CREATE_TIME_ENTRY, CLOCKIFY_GET_TIME_ENTRIES

Start a timer on project abc in workspace xyz with description "Working on bug fix"

• Create without end to start a running timer
• Use CLOCKIFY_GET_TIME_ENTRIES with in-progress: true to check if a timer is running

Known Pitfalls

• Workspace and user IDs are required: Most Clockify tools require both workspaceId and userId. Always call CLOCKIFY_GET_ALL_MY_WORKSPACES and CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO first to resolve these IDs.
• ISO 8601 timestamps: All time parameters must be in ISO 8601 format with timezone (e.g., 2026-02-11T09:00:00Z). Omitting the timezone causes unpredictable behavior.
• Running timers: Only one timer can run at a time. Creating a new entry without end will fail if another timer is already active. Stop the existing timer first.
• Pagination defaults: CLOCKIFY_GET_TIME_ENTRIES defaults to 50 entries per page. For full exports, loop through pages until no more results are returned.
• Tag IDs are workspace-scoped: Tag IDs from one workspace cannot be used in another. Always resolve tags within the target workspace context.

Quick Reference

Powered by Composio