Toggl-Optimized-V2

Optimize Toggl Track usage with token-efficient API calls and fast reporting via a shell script for JSON and PDF summaries.

Toggl-Optimized

A high-performance Toggl Track agent skill optimized for token efficiency and reporting.

Overview

This skill provides a streamlined way to interact with Toggl Track, focusing on minimizing context usage and providing fast reporting capabilities via direct API v3 calls.

Features

• Token Efficient: Uses optimized API calls to reduce LLM context consumption.
• Fast Reporting: Includes a shell script for quick JSON and PDF reports.
• Direct API Access: Examples for direct curl interaction with Toggl v3 Reports.

Setup

1. Get your API Token from Toggl Profile Settings.
2. Set the environment variable:

   export TOGGL_API_TOKEN="your-api-token"
   

3. (Optional) Set your Workspace ID:

   export TOGGL_WORKSPACE_ID="your-workspace-id"
   

Usage

Optimized Reporting Script

Use the provided script for fast summaries:

# Usage: bash scripts/toggl_report.sh <client_name> <start_date> <end_date> <format: json|pdf>
bash scripts/toggl_report.sh myclient 2026-02-01 2026-02-28 json