generate_report¶

Generate a summary report of time entries for a given period.

Summary¶

The generate_report tool allows you to create a summarized report of time tracking data. It aggregates entries by activity and provides totals and percentages. This is useful for weekly reviews or billing.

Parameters¶

Parameter	Type	Required	Description
`startDate`	string	Required	Start date for the report period (YYYY-MM-DD).
`endDate`	string	Required	End date for the report period (YYYY-MM-DD).
`projectId`	string	Optional	Filter report for a specific activity ID.

Behavior¶

Validation: Checks date formats.
Data Fetching: Retrieves raw time entries for the period.
Aggregation: Client-side calculation of totals per activity.
Formatting: Formats durations (e.g., "2h 15m") and calculates percentages.
Response: Returns a structured text summary.

Examples¶

Weekly Report¶

Generate Report

{
  "startDate": "2025-10-13",
  "endDate": "2025-10-19"
}

Response:

📊 Time Report (2025-10-13 to 2025-10-19)

Total Duration: 35h 30m
Entries: 42

By Activity:
- Client Work: 20h 0m (56.3%)
- Internal Meetings: 10h 30m (29.6%)
- Development: 5h 0m (14.1%)