A feature-rich command-line interface for interacting with Toggl Track workspaces, enabling seamless time management directly from the terminal.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install toggl-cli
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install toggl-cli using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Toggl CLI?
The Toggl CLI skill is a powerful developer tool designed to bridge the gap between your coding environment and Toggl Track's time-tracking capabilities. By leveraging this skill within the Openclaw Skills ecosystem, developers can manage their entire tracking workflow—from starting timers to generating client reports—without ever leaving the terminal. It provides a structured, scriptable way to interact with the Toggl API v9, making it an essential component for high-performance engineering teams.
This skill is built for those who value speed and automation. Whether you are using it as a standalone tool or integrating it with AI agents like Claude Code, the Toggl CLI ensures that logging work hours is as frictionless as committing code. Its ability to output data in various formats makes it a versatile choice for anyone looking to build custom productivity dashboards or automated reporting pipelines using Openclaw Skills.
Toggl CLI Use Cases
- Starting and stopping project timers instantly during a terminal-based development session.
- Auditing weekly time entries to ensure accurate billing and project allocation.
- Automating the creation of projects and tasks for new client onboarding workflows.
- Querying workspace and organization data for team-wide productivity analysis.
- Integrating time-tracking triggers into shell scripts or CI/CD pipelines via Openclaw Skills.
How Toggl CLI Works
- The user authenticates using a Toggl API token, which the CLI uses for secure HTTP Basic Authentication.
- Commands are issued via the
togglentry point, targeting specific resources like time entries (te) or projects (proj). - The CLI sends formatted REST requests to the Toggl v9 API endpoints.
- It automatically manages API rate limits using a leaky bucket algorithm and exponential backoff to ensure reliable data transmission.
- The tool processes the JSON response from the server and renders it according to the user's specified format (table, CSV, or JSON).
Toggl CLI Setup
To get started with this skill, clone the repository and install the dependencies globally on your system:
git clone https://github.com/FroeMic/toggl-cli
cd toggl-cli
npm install
npm run build
npm link
Configure your environment by setting your API token. For optimal use with Openclaw Skills, add this to your environment configuration file:
export TOGGL_API_TOKEN="your-api-token"
# Optional: Set your default workspace for faster commands
export TOGGL_WORKSPACE_ID="your-workspace-id"
Toggl CLI Data Schema & Taxonomy
The skill interacts with several core data entities within the Toggl ecosystem. The following table describes how data is organized:
| Entity | Purpose | Key Metadata |
|---|---|---|
| Time Entries | Tracks specific work durations | description, start_date, duration, tags, project_id |
| Projects | Groups related tasks and entries | name, color, active_status, client_id |
| Clients | Represents the entity being billed | name, notes, archive_status |
| Workspaces | Top-level containers for data | id, name, organization_id |
| Tags | Categorical labels for entries | name |
| Tasks | Granular sub-items for projects | name, estimated_time |
Toggl CLI Advanced Features
- Flexible output formatting allows for easy data piping into other Openclaw Skills using JSON, CSV, or Table views.
- Built-in rate limit handling ensures the CLI remains stable even during high-frequency API calls.
- Comprehensive organization and group management for administrators handling large teams.
- Support for advanced time entry manipulation including manual creation with specific ISO 8601 timestamps and durations.
- Seamless compatibility with AI agents, allowing Openclaw Skills to perform natural language queries against your time tracking data.
SKILL.md
Loading
Related Openclaw Skills
Specter CLI
A powerful command-line interface for the Specter platform to automate company enrichment and professional data management.
Notion CLI
A production-grade command-line interface for the Notion API, enabling seamless workspace management through the terminal.
Attio CRM CLI
A command-line interface for interacting with Attio CRM workspaces, enabling seamless record and pipeline management.
The Playground
A virtual social ecosystem where AI agents can interact, navigate rooms, and socialize in real-time.
Tavily Search
A high-performance web search engine specifically optimized to provide AI agents with clean, context-rich information.
Tavily Search
A specialized web search and content extraction skill optimized specifically for AI agents to retrieve clean, high-relevance data.
Featured*
