clockify

Start, stop, and list Clockify timers via the clockify.py CLI.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/steverozen/clockify-skill --skill clockify
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: clockify
Source: https://github.com/steverozen/clockify-skill/tree/main
Command: npx skills add https://github.com/steverozen/clockify-skill --skill clockify

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables you to manage Clockify timers from natural language, wrapping the local clockify.py CLI so you can start, stop, and query time entries without leaving your workflow.

Core Features & Use Cases

  • Start a timer for a specific client and project using case-insensitive globs.
  • Stop the currently running timer and view a duration.
  • List clients and projects, or check the status of the active timer.
  • No PATH dependency: invoke clockify.py by its absolute path; works inside Claude Code across machines.

Quick Start

Ask Claude to start a timer for a client and project, e.g., clockify start 'client' 'project'.

Frequently Asked Questions about clockify

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a Clockify timer using natural language?

You can start a Clockify timer by asking Claude to start a timer for a specific client and project using case-insensitive globs. The Skill wraps the clockify.py CLI to process natural-language prompts and automatically initiate time tracking without manual CLI commands.

Can I manage Clockify time tracking without leaving my development workflow?

Yes, this Skill automates Clockify time tracking by wrapping the local clockify.py CLI, allowing developers and operators to start, stop, and query time entries directly within their workflow using natural-language prompts.

What do I need to set up before using natural language prompts for Clockify timers?

You need to provide a valid CLOCKIFY_API_KEY and have the Python standard library available. The Skill invokes clockify.py by its absolute path, ensuring it works across machines without requiring PATH configuration.

What happens if my client or project glob matches multiple Clockify entries?

The Skill enforces an exactly-one-match rule when starting timers with case-insensitive globs for clients and projects. If multiple matches are found, it provides robust error handling with verbose guidance to help you refine your search.

Is there a way to automatically stop a running Clockify timer if I forget?

Yes, the Skill includes an auto-stop safety banner designed to prevent timers from running indefinitely. You can also check the status of the active timer or stop it manually using a natural-language prompt to view the duration.

How do I list available Clockify clients and projects to start tracking time?

You can ask Claude to list clients and projects directly using natural language. The Skill queries the clockify.py CLI to retrieve and display available entries, helping you find the exact names needed for your time-tracking globs.