Time tracking with Toggl. Use this skill when: - Starting or stopping time entries - Checking current timer status - Generating time reports (daily, weekly, by project) - Reviewing productivity and time allocation - Managing projects and workspaces
Manage time tracking with Toggl using the Track-Report-Analyze pattern.
mcp__toggl__toggl_get_current_entry({})
Returns the running timer (if any) with:
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.
mcp__toggl__toggl_stop_timer({})
mcp__toggl__toggl_list_projects({
workspaceId: 12345 // optional
})
mcp__toggl__toggl_list_workspaces({})
mcp__toggl__toggl_get_time_entries({
startDate: "2025-01-01",
endDate: "2025-01-31"
})
Returns hydrated entries with project and workspace names.
mcp__toggl__toggl_daily_report({
date: "2025-01-15" // optional, defaults to today
})
Returns:
mcp__toggl__toggl_weekly_report({
startDate: "2025-01-13",
endDate: "2025-01-19"
})
Returns:
mcp__toggl__toggl_project_summary({
startDate: "2025-01-01",
endDate: "2025-01-31"
})
mcp__toggl__toggl_workspace_summary({
startDate: "2025-01-01",
endDate: "2025-01-31"
})
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:
mcp__toggl__toggl_list_clients({
workspaceId: 12345
})
Cross-reference with project data for client billing.
## 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 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%)
Pre-load workspace, project, and client data for faster queries:
mcp__toggl__toggl_warm_cache({})
Run this at session start for better performance.
Verify connection is valid:
mcp__toggl__toggl_check_auth({})