tomevault-io Time Tracking Skill
Manage time tracking with Toggl using the Track-Report-Analyze pattern.
Phase 1: TRACK (Manage Timers)
Check Current Status
mcp__toggl__toggl_get_current_entry({})
Returns the running timer (if any) with:
- Description
- Project name
- Duration so far
- Start time
Start a Timer
mcp__toggl__toggl_start_timer({
description: "Working on feature implementation",
projectId: 12345, // optional
workspaceId: 67890, // optional
tags: ["development"] // optional
})
If a timer is already running, it will be stopped automatically.
Stop Current Timer
mcp__toggl__toggl_stop_timer({})
List Projects for Selection
mcp__toggl__toggl_list_projects({
workspaceId: 12345 // optional
})
List Workspaces
mcp__toggl__toggl_list_workspaces({})
Phase 2: REPORT (View Time Data)
Get Time Entries
mcp__toggl__toggl_get_time_entries({
startDate: "2025-01-01",
endDate: "2025-01-31"
})
Returns hydrated entries with project and workspace names.
Daily Report
mcp__toggl__toggl_daily_report({
date: "2025-01-15" // optional, defaults to today
})
Returns:
- Total hours for the day
- Breakdown by project
- Breakdown by workspace
- List of entries
Weekly Report
mcp__toggl__toggl_weekly_report({
startDate: "2025-01-13",
endDate: "2025-01-19"
})
Returns:
- Total hours for the week
- Daily breakdown
- Project summaries
- Workspace summaries
Project Summary
mcp__toggl__toggl_project_summary({
startDate: "2025-01-01",
endDate: "2025-01-31"
})
Workspace Summary
mcp__toggl__toggl_workspace_summary({
startDate: "2025-01-01",
endDate: "2025-01-31"
})
Phase 3: ANALYZE (Insights)
Compare Periods
Compare current week to previous:
// This week
const thisWeek = mcp__toggl__toggl_weekly_report({
startDate: "2025-01-20",
endDate: "2025-01-26"
})
// Last week
const lastWeek = mcp__toggl__toggl_weekly_report({
startDate: "2025-01-13",
endDate: "2025-01-19"
})
Then calculate:
- Week-over-week change
- Project allocation shifts
- Productivity trends
Client Hours
mcp__toggl__toggl_list_clients({
workspaceId: 12345
})
Cross-reference with project data for client billing.
Report Formatting
Daily Summary Example
## Daily Report - January 15, 2025
**Total: 7h 32m**
### By Project
| Project | Hours |
|---------|-------|
| Client A - Website | 3h 15m |
| Internal - Planning | 2h 00m |
| Client B - API | 2h 17m |
### Entries
1. 09:00-12:15 - Client A - Website - Homepage redesign
2. 13:00-15:00 - Internal - Planning - Q1 roadmap
3. 15:15-17:32 - Client B - API - Payment integration
Weekly Summary Example
## Weekly Report - Jan 13-19, 2025
**Total: 38h 45m** (vs 35h 20m last week, +9.7%)
### Daily Breakdown
| Day | Hours |
|-----|-------|
| Mon | 8h 15m |
| Tue | 7h 30m |
| Wed | 8h 00m |
| Thu | 7h 45m |
| Fri | 7h 15m |
### Top Projects
1. Client A - Website: 15h 30m (40%)
2. Internal - Development: 12h 00m (31%)
3. Client B - API: 8h 15m (21%)
4. Other: 3h 00m (8%)
Performance Optimization
Warm Cache
Pre-load workspace, project, and client data for faster queries:
mcp__toggl__toggl_warm_cache({})
Run this at session start for better performance.
Check Auth
Verify connection is valid:
mcp__toggl__toggl_check_auth({})
Best Practices
Do
- Start timers with clear descriptions
- Assign projects for accurate reporting
- Use consistent tags across entries
- Review daily/weekly reports regularly
- Warm cache at session start
Don't
- Leave timers running overnight unintentionally
- Create entries without descriptions
- Skip project assignment for billable work
- Forget to stop timer when switching tasks
Converted and distributed by TomeVault — claim your Tome and manage your conversions.