{"kind":"Skill","metadata":{"namespace":"community","name":"clockify-automation","version":"0.1.0"},"spec":{"description":"Automate time tracking workflows in Clockify -- create and manage time entries, workspaces, and users through natural language commands.","files":{"SKILL.md":"---\nname: Clockify Automation\ndescription: \"Automate time tracking workflows in Clockify -- create and manage time entries, workspaces, and users through natural language commands.\"\nrequires:\n  mcp:\n    - rube\n---\n\n# Clockify Automation\n\nAutomate 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.\n\n**Toolkit docs:** [composio.dev/toolkits/clockify](https://composio.dev/toolkits/clockify)\n\n---\n\n## Setup\n\n1. Add the Rube MCP server to your Claude Code config with URL: `https://rube.app/mcp`\n2. When prompted, authenticate your Clockify account through the connection link provided\n3. Start automating your time tracking workflows with natural language\n\n---\n\n## Core Workflows\n\n### 1. Create Time Entries\n\nLog time with project, task, and tag associations, plus billable status.\n\n**Tool:** `CLOCKIFY_CREATE_TIME_ENTRY`\n\n```\nLog 2 hours of work on project 64a687e2 in workspace 64a687e3 starting at 9am UTC today with description \"API development\"\n```\n\nKey parameters:\n- `workspaceId` (required) -- workspace where the entry is created\n- `start` (required) -- ISO 8601 start time (e.g., `2026-02-11T09:00:00Z`)\n- `end` -- ISO 8601 end time; omit to create a running timer\n- `projectId` -- associate with a project\n- `taskId` -- associate with a task\n- `description` -- work description (0-3000 chars)\n- `tagIds` -- array of tag IDs\n- `billable` -- whether the entry is billable\n- `customFieldValues` -- array of custom field entries with `customFieldId` and `value`\n\n### 2. Query Time Entries\n\nRetrieve historical time entries for reporting, auditing, and invoicing.\n\n**Tool:** `CLOCKIFY_GET_TIME_ENTRIES`\n\n```\nGet all time entries for user abc123 in workspace xyz789 from January 2026\n```\n\nKey parameters:\n- `workspaceId` (required) -- workspace to query\n- `userId` (required) -- user whose entries to retrieve\n- `start` / `end` -- ISO 8601 date range filters\n- `project` -- filter by project ID\n- `task` -- filter by task ID\n- `tags` -- comma-separated tag IDs\n- `description` -- text filter (partial match)\n- `hydrated` -- set `true` to get full project/task/tag objects instead of just IDs\n- `in-progress` -- set `true` to return only the running timer\n- `page` / `page-size` -- pagination (default 50 per page)\n\n### 3. Delete Time Entries\n\nRemove erroneous, duplicate, or cancelled time entries.\n\n**Tool:** `CLOCKIFY_DELETE_TIME_ENTRY`\n\n```\nDelete time entry 5b715448 from workspace 64a687e3\n```\n\n- Requires `workspaceId` and `id` (the time entry ID)\n- Use for cleanup of bad imports or duplicates\n\n### 4. Manage Workspaces\n\nList all workspaces the authenticated user belongs to.\n\n**Tool:** `CLOCKIFY_GET_ALL_MY_WORKSPACES`\n\n```\nShow me all my Clockify workspaces\n```\n\n- Optional `roles` filter -- array of roles like `[\"WORKSPACE_ADMIN\", \"OWNER\"]`\n- Use this to discover workspace IDs before creating or querying entries\n\n### 5. User Information\n\nRetrieve current user details and list workspace members.\n\n**Tools:** `CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO`, `CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE`\n\n```\nWho am I logged in as? Then list all users in workspace 64a687e3\n```\n\n- `CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO` returns the authenticated user's profile (no parameters needed)\n- `CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE` requires `workspaceId`; supports `name`, `email` filters and pagination (`page`, `page-size` max 100)\n\n### 6. Running Timer Management\n\nStart a timer by omitting `end` in create, or check for running entries.\n\n**Tools:** `CLOCKIFY_CREATE_TIME_ENTRY`, `CLOCKIFY_GET_TIME_ENTRIES`\n\n```\nStart a timer on project abc in workspace xyz with description \"Working on bug fix\"\n```\n\n- Create without `end` to start a running timer\n- Use `CLOCKIFY_GET_TIME_ENTRIES` with `in-progress: true` to check if a timer is running\n\n---\n\n## Known Pitfalls\n\n- **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.\n- **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.\n- **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.\n- **Pagination defaults:** `CLOCKIFY_GET_TIME_ENTRIES` defaults to 50 entries per page. For full exports, loop through pages until no more results are returned.\n- **Tag IDs are workspace-scoped:** Tag IDs from one workspace cannot be used in another. Always resolve tags within the target workspace context.\n\n---\n\n## Quick Reference\n\n| Tool Slug | Description |\n|---|---|\n| `CLOCKIFY_CREATE_TIME_ENTRY` | Create a time entry or start a timer (requires `workspaceId`, `start`) |\n| `CLOCKIFY_GET_TIME_ENTRIES` | List time entries with filters (requires `workspaceId`, `userId`) |\n| `CLOCKIFY_DELETE_TIME_ENTRY` | Delete a time entry (requires `workspaceId`, `id`) |\n| `CLOCKIFY_GET_ALL_MY_WORKSPACES` | List all workspaces for the authenticated user |\n| `CLOCKIFY_GET_CURRENTLY_LOGGED_IN_USER_INFO` | Get current user profile info |\n| `CLOCKIFY_FIND_ALL_USERS_ON_WORKSPACE` | List all users in a workspace (requires `workspaceId`) |\n\n---\n\n*Powered by [Composio](https://composio.dev)*\n"},"import":{"commit_sha":"f2b5e29bc315f04c8e09591ba275f4c4f7d4b8fe","imported_at":"2026-05-18T20:07:47Z","license_text":"","owner":"ComposioHQ","repo":"ComposioHQ/awesome-claude-skills","source_url":"https://github.com/ComposioHQ/awesome-claude-skills/tree/f2b5e29bc315f04c8e09591ba275f4c4f7d4b8fe/composio-skills/clockify-automation"}},"content_hash":[220,231,100,82,51,170,126,135,26,238,89,145,245,0,97,109,189,236,186,104,2,255,211,76,163,205,56,162,216,192,174,198],"trust_level":"unsigned","yanked":false}