Agent skill
time-tracking
Time tracking integration patterns with RescueTime and Toggl APIs for automated time entry, reporting, analytics, and project/task attribution
Install this agent skill to your Project
npx add-skill https://github.com/vamseeachanta/workspace-hub/tree/main/.claude/skills/business/productivity/time-tracking
SKILL.md
Time Tracking
When to Use This Skill
USE Time Tracking APIs when:
- Automating time entries - Log time from scripts, CI/CD, or other tools
- Building productivity dashboards - Aggregate time data for analysis
- Project billing - Track billable hours automatically
- Focus time analysis - Understand productivity patterns
- Team time management - Aggregate team time data
- Integration pipelines - Connect time tracking with task managers
- Automated reporting - Generate time reports programmatically
- Custom analytics - Build specialized productivity insights
DON'T USE Time Tracking APIs when:
- Simple manual tracking - Use native apps instead
- Real-time monitoring - APIs have rate limits
- Invasive employee surveillance - Ethical concerns
- Complex invoicing - Use dedicated billing software
Prerequisites
Toggl Track Setup
# Get API token from:
# https://track.toggl.com/profile (scroll to API Token)
# Set environment variable
export TOGGL_API_TOKEN="your-api-token"
# Toggl uses HTTP Basic Auth with token as username, "api_token" as password
# Or you can use the token directly
# Verify authentication
curl -s -u "$TOGGL_API_TOKEN:api_token" \
"https://api.track.toggl.com/api/v9/me" | jq '.fullname'
RescueTime Setup
# Get API Key from:
# https://www.rescuetime.com/anapi/manage
# Set environment variable
export RESCUETIME_API_KEY="your-api-key"
# Verify authentication
curl -s "https://www.rescuetime.com/anapi/data?key=$RESCUETIME_API_KEY&format=json&restrict_kind=overview" | jq
Python Setup
# Install dependencies
pip install requests python-dateutil pandas
# Using uv
uv pip install requests python-dateutil pandas
# Optional: For Toggl SDK
pip install toggl-python
# Verify
python -c "import requests; print('Ready for time tracking integration!')"
Version History
- 1.0.0 (2026-01-17): Initial release
- Toggl Track API integration
- RescueTime API integration
- Time entry automation
- Reports and analytics
- Project attribution
- Weekly report generator
- Productivity dashboard
- GitHub Actions integration
- Slack integration
Resources
- Toggl Track API: https://engineering.toggl.com/docs/
- Toggl Reports API: https://engineering.toggl.com/docs/reports
- RescueTime API: https://www.rescuetime.com/anapi/setup/documentation
- py-toggl: https://github.com/toggl/toggl_api_docs
Automate your time tracking workflows with Toggl and RescueTime APIs!
Sub-Skills
- 1. Toggl Track - Time Entries
- 2. Toggl Track - Projects and Clients
- 3. Toggl Track - Reports
- 4. RescueTime - Data Retrieval
- 5. RescueTime - FocusTime Triggers (+1)
- Time Tracking with GitHub Actions (+1)
- 1. Handle Rate Limits (+2)
- Common Issues
Sub-Skills
- Example 1: Weekly Time Report Generator
- Hours by Day
- Top Categories (+2)
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
gsd-complete-milestone
Archive completed milestone and prepare for next version
gsd-reapply-patches
Reapply local modifications after a GSD update
gsd-verify-work
Validate built features through conversational UAT
gsd-thread
Manage persistent context threads for cross-session work
clinical-trial-protocol
Generate clinical trial protocols for medical devices or drugs through a modular, waypoint-based architecture with research-only and full protocol modes.
single-cell-rna-qc
Performs quality control on single-cell RNA-seq data (.h5ad or .h5 files) using scverse best practices with MAD-based filtering and comprehensive visualizations.
Didn't find tool you were looking for?