Clockify Integration

Pro v1.0.0

Track time, manage projects, and generate reports using the Clockify time tracking API

Requires Claude Code CLI

This skill integrates with Clockify through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

Get Workspaces

List all workspaces you have access to

Returns

array Array of workspace objects with id, name, and settings

Try saying...

  • "Show me my Clockify workspaces"
  • "List all my workspaces"
  • "What workspaces do I have access to?"

Get User Info

Get information about the currently authenticated user

Returns

object User object with id, name, email, and settings

Try saying...

  • "Show my Clockify user profile"
  • "Get my user information"
  • "Who am I logged in as?"

List Projects

List all projects in a workspace

Parameters

Name Type Required Description
workspace_id string Required The workspace ID to list projects from

Returns

array Array of project objects

Try saying...

  • "List all projects in my workspace"
  • "Show me the projects"
  • "What projects exist in workspace X?"

Get Time Entries

Get recent time entries for the current user

Parameters

Name Type Required Description
workspace_id string Required The workspace ID

Returns

array Array of time entry objects

Try saying...

  • "Show my recent time entries"
  • "What have I tracked today?"
  • "Get my time entries"

Start Timer

Start a new time entry timer

Parameters

Name Type Required Description
workspace_id string Required The workspace ID
description string Required Description of what you're working on
project_id string Optional Optional project ID to associate with this entry

Returns

object The created time entry object

Try saying...

  • "Start tracking time for 'Writing documentation'"
  • "Start a timer for my current task"
  • "Begin tracking time on project X"

Stop Timer

Stop the currently running timer

Parameters

Name Type Required Description
workspace_id string Required The workspace ID

Returns

object The updated time entry object with end time

Try saying...

  • "Stop my current timer"
  • "End the running time entry"
  • "Stop tracking time"

Create Project

Create a new project in a workspace

Parameters

Name Type Required Description
workspace_id string Required The workspace ID
name string Required Project name

Returns

object The created project object

Try saying...

  • "Create a new project called 'Website Redesign'"
  • "Add a project named X"
  • "Make a new project for Y"

Generate Report

Generate a detailed time report for a date range

Parameters

Name Type Required Description
workspace_id string Required The workspace ID
start_date string Required Start date in ISO 8601 format
end_date string Required End date in ISO 8601 format

Returns

object Detailed report with time entries and totals

Try saying...

  • "Generate a report for last week"
  • "Show me a time report for December"
  • "Get a detailed report from date X to date Y"

Getting Started

API Key Easy Setup
  1. 1 Log in to your Clockify account at https://app.clockify.me
  2. 2 Click your profile icon > Profile Settings
  3. 3 Scroll to the API section and click Generate
  4. 4 Copy the generated API key (shown only once)
  5. 5 Add to shell config: echo 'export CLOCKIFY_API_KEY="YOUR_KEY"' >> ~/.zshrc
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

source ~/.config/claude-skills/clockify-api/.venv/bin/activate && python scripts/client.py get-user

Success: Returns your user profile with name and email

View full setup guide

Security & Access

Access Scope

Full access to all workspaces, projects, time entries, and reports associated with your Clockify account. Can create, update, and delete resources based on your user permissions.

  • API key grants the same access as your user account in the Clockify UI
  • Never share your API key or commit it to version control
  • Anyone with your API key can track time, modify projects, and access all your data
  • Regenerate your API key immediately if it may have been compromised
  • API keys cannot be viewed again after creation - store securely

Limitations

  • Some features require paid subscription (e.g., adding time for others)
  • Subdomain workspaces require workspace-specific API keys
  • API permissions follow the same model as the UI - user role dependent

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
REST API
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements