toggl

Toggl Time Tracker

Track time and pull reports via the Toggl Track API.

Environment note: This skill works in both Claude Code and Cowork. The only difference is how the config file is read in Step 1 — Claude Code reads it directly, Cowork uses osascript.

---

Step 1: Read the config

The config lives on the Mac at ~/.toggl-config.json.

In Claude Code (direct file system access):

CONFIG=$(cat ~/.toggl-config.json 2>/dev/null || echo "NOT_CONFIGURED")

In Cowork (VM — needs osascript to reach the Mac home):

CONFIG=$(osascript -e 'do shell script "cat ~/.toggl-config.json 2>/dev/null || echo NOT_CONFIGURED"')

Then parse it safely in Python — never log or print the raw config or API token:

python3 -c "
import json, sys, base64
raw = '''$CONFIG'''
if raw.strip() == 'NOT_CONFIGURED':
    print('STATUS:NOT_CONFIGURED')
    sys.exit(0)
try:
    cfg = json.loads(raw)
    token = cfg['apiToken']
    # Build Basic Auth header: token:api_token base64-encoded
    auth = base64.b64encode(f'{token}:api_token'.encode()).decode()
    print('STATUS:OK')
    print(f'AUTH:Basic {auth}')
    print(f'WORKSPACE:{cfg.get(\"workspaceId\", \"\")}')
except Exception as e:
    print(f'STATUS:PARSE_ERROR:{e}')
"

• If STATUS:NOT_CONFIGURED → tell the user:

  "Toggl isn't set up yet. Create ~/.toggl-config.json with your API token:

  {
    "apiToken": "your-toggl-api-token",
    "workspaceId": 1234567
  }
  

  Find your API token at https://track.toggl.com/profile (scroll to 'API Token'). Find your workspace ID in the URL when logged into Toggl: https://track.toggl.com/{workspaceId}/timer." Stop here.

• If STATUS:PARSE_ERROR → tell the user the config file is malformed.
• If STATUS:OK → extract AUTH and WORKSPACE from output. Continue.

IMPORTANT: The API token belongs to the user. Never print it, log it, or include it in any output shown to the user.

---

API Base

All requests go to:

https://api.track.toggl.com/api/v9