Time Tracking Analyst
Analyze your time tracking data to find patterns, optimize your schedule, and boost productivity
🧂 Ingredients
🔌 APIs
time_entries_projects_and_tags_for_work_tracking
🔄 Alternatives:
cross_reference_time_entries_with_calendar_events
🔄 Alternatives:
alerts_for_long_untracked_periods
🔄 Alternatives:
📋 Step-by-Step Build Guide
Connect to Toggl API and pull time entries for the current week
1. Connect to Toggl API and pull time entries for the current week
Connect to Toggl API and pull time entries for the current week Steps: 1. Validate all required inputs are available 2. Execute the operation described above 3. Verify the result meets expected output format 4. Handle errors gracefully — retry transient failures, log and alert on persistent ones 5. Return structured output with status and any relevant data If any required data is missing, request it from the user before proceeding.
🧑 Human Required
- • ## Connect the API 1. Sign up for the service if you don't have an account 2. Find the API settings in your account dashboard 3. Generate an API key or access token 4. Share the key with your agent when prompted 💡 Most services have a free tier that's sufficient to get started.
Categorize entries
2. Categorize entries: Deep Work, Meetings, Admin/Email, Learning, Breaks, Other
Analyze the input and classify it into the defined categories.
Classification approach:
1. Extract key signals from the content (keywords, sender, urgency markers, topic)
2. Match against category definitions
3. Assign confidence score (high/medium/low)
4. For ambiguous cases, classify as the more important/urgent category (err on the side of caution)
Output for each item: { category, priority, confidence, reasoning }
If an item could belong to multiple categories, pick the primary one and note the secondary.Calculate daily totals per category and identify time allocation ratios
3. Calculate daily totals per category and identify time allocation ratios
Process the data and calculate the requested metrics. Steps: 1. Validate input data — check for nulls, out-of-range values, duplicates 2. Apply the calculation/aggregation logic 3. Compare against benchmarks or previous periods if available 4. Format results with appropriate precision (2 decimal places for percentages, whole numbers for counts) Include: current value, previous value, change (absolute and %), trend direction (↑↓→). Flag any anomalies: values >2 standard deviations from the mean. If insufficient data for a reliable calculation, state the minimum needed and return partial results.
Detect patterns
4. Detect patterns: what hours are your most productive? When do you have the most deep work?
Detect patterns: what hours are your most productive? When do you have the most deep work? Steps: 1. Validate all required inputs are available 2. Execute the operation described above 3. Verify the result meets expected output format 4. Handle errors gracefully — retry transient failures, log and alert on persistent ones 5. Return structured output with status and any relevant data If any required data is missing, request it from the user before proceeding.
Cross
5. Cross-reference with calendar: are meetings eating into your peak productivity hours?
Process the data and calculate the requested metrics. Steps: 1. Validate input data — check for nulls, out-of-range values, duplicates 2. Apply the calculation/aggregation logic 3. Compare against benchmarks or previous periods if available 4. Format results with appropriate precision (2 decimal places for percentages, whole numbers for counts) Include: current value, previous value, change (absolute and %), trend direction (↑↓→). Flag any anomalies: values >2 standard deviations from the mean. If insufficient data for a reliable calculation, state the minimum needed and return partial results.
Alert if you've had >2 hours untracked during work hours (accountability nudge)
6. Alert if you've had >2 hours untracked during work hours (accountability nudge)
Monitor the data for anomalies and trigger alerts when thresholds are exceeded. Detection rules: 1. Compare current values against defined thresholds 2. Check for sudden changes (>X% deviation from rolling average) 3. Look for pattern breaks (missing expected data, unusual timing) 4. Cross-reference multiple signals for higher confidence For each detected anomaly: - Severity: 🔴 Critical (immediate action) / 🟡 Warning (attention needed) / 🔵 Info (notable) - What: specific metric and current value - Why: what threshold or pattern was violated - Context: recent trend, baseline comparison - Suggested action: what to do about it Suppress duplicate alerts — don't re-alert for the same issue within the configured cooldown period.
Weekly report
7. Weekly report: total hours by category, deep work ratio, meeting load, most/least productive days
Compile the gathered data into a structured report. Format as clean Markdown with: - Title/date header - Executive summary (2-3 sentences) - Key metrics section with actual numbers - Detailed sections with bullet points - Action items or recommendations at the end Keep it scannable — busy people read reports in 30 seconds. Use emoji sparingly for visual anchors (📊 metrics, ✅ wins, ⚠️ concerns, 📋 action items). Include data comparisons: "X this period vs Y last period (↑Z%)" If any data source was unavailable, note it clearly: "⚠️ [Source] data unavailable — excluded from this report."
Monthly
8. Monthly: trend analysis — is your deep work time increasing? Are meetings creeping up? Recommendations.
Monthly: trend analysis — is your deep work time increasing? Are meetings creeping up? Recommendations. Steps: 1. Validate all required inputs are available 2. Execute the operation described above 3. Verify the result meets expected output format 4. Handle errors gracefully — retry transient failures, log and alert on persistent ones 5. Return structured output with status and any relevant data If any required data is missing, request it from the user before proceeding.
🤖 Example Agent Prompt
Connect to Toggl API and pull time entries for the current week Steps: 1. Validate all required inputs are available 2. Execute the operation described above 3. Verify the result meets expected output format 4. Handle errors gracefully — retry transient failures, log and alert on persistent ones 5. Return structured output with status and any relevant data If any required data is missing, request it from the user before proceeding.
Copy this prompt into your agent to get started.