Time Tracking
Track time spent on tasks and activities with start/stop timers, manual logging, and summaries. A native feature — no external service required. Just tell your agent what you're working on.
Tools
| Tool | Description |
|---|---|
| start_time_tracking | Start a timer on an activity (auto-stops any running timer) |
| stop_time_tracking | Stop the currently running timer |
| log_time | Manually log a completed time entry |
| list_time_entries | List recent time entries with durations |
| get_time_summary | Get totals by tag for a period (today / week / month) |
| delete_time_entry | Remove a time entry |
Use Cases
Freelancers & Billing
User: "Start tracking time on client meeting with Acme Corp, billable"
Agent: Starts a timer tagged as billable. When you say "done with the meeting", the agent stops the timer and logs the duration.
User: "How many billable hours this week?"
Agent: Uses get_time_summary to calculate billable totals for the week.
Developer Workflows
User: "Track time on code review for the auth module"
The agent starts a timer with tags like "engineering" and "review". Link to a specific task for per-task time reporting.
User: "I spent 3 hours debugging the login issue yesterday, log that"
Agent: Manually logs a 3-hour entry with a past start time.
Productivity Analysis
User: "How much time am I spending on meetings vs. deep work this week?"
The agent pulls summaries grouped by tag and gives you a breakdown. Use tags like "meetings", "coding", "review", "admin" to categorize your work.
Automation Combos
Combine with Scheduled Actions for recurring reports:
"Every Friday at 5pm, email me a weekly timesheet summary."
Combine with Automations for event-driven workflows:
"When a timer stops and duration > 4 hours, create a note summarizing what was accomplished."
Page UI
The Time Tracking page shows a live timer banner, start/stop controls, a manual entry form, and all entries grouped by day with duration totals. Summary stats for today and this week appear in the header.
Events
| Event | Description |
|---|---|
| time_tracking.started | A timer was started |
| time_tracking.stopped | A timer was stopped |
| time_tracking.logged | A time entry was manually logged |
| time_tracking.deleted | A time entry was deleted |
Key Details
| Detail | Value |
|---|---|
| Running timers per agent | 1 (starting a new one auto-stops the previous) |
| Tags | Unlimited, comma-separated |
| Billable flag | Per-entry, used in summaries |
| Task linking | Optional — link entries to tasks for per-task reporting |
| Auto-create page | Agent creates the page automatically on first use |