List all active Productive.io projects from local cache.

Returns id, name, number, and company for each project. Cache refreshes automatically every hour, or call productive_refresh_cache to force it.

Fuzzy-search projects by name or number.

Args: query: Partial name or number (e.g. "Acme", "1099"). limit: Max matches to return (default 5).

List services (billable activity types) on a given project.

Args: project: Project name (fuzzy) or numeric project id.

Create a time entry on a Productive.io project.

Args: project: Project name (fuzzy match, e.g. "1099 Acme") or numeric id. hours: Hours worked (float, e.g. 2.5). Converted to minutes internally. note: Optional description of the work. date: ISO date (YYYY-MM-DD). Defaults to today. service_hint: Optional service name/id if the project has multiple services. Once chosen, remembered as the project default.

List time entries, newest first.

Args: after: ISO date (YYYY-MM-DD) — include entries on/after this date. before: ISO date (YYYY-MM-DD) — include entries on/before this date. project: Project name or id to filter by. mine_only: If True (default), only return entries for the authenticated user.

Edit a time entry. Only provide fields you want to change.

Args: entry_id: Time entry ID (from productive_list_time_entries). hours: New hours value. date: New ISO date (YYYY-MM-DD). note: New note text. service_hint: New service name or id.

Permanently delete a time entry.

Args: entry_id: Time entry ID.

Force-refresh the projects/services/deals cache from Productive.

Call after creating new projects or services in Productive so they're visible to find_project.

Explicitly set (or override) the remembered default service for a project.

Args: project: Project name or id. service: Service name or id. Must belong to the project.

Fuzzy-search people in the organisation by name or email.

Args: query: Partial name or email (e.g. "Alice", "alice@example.com"). limit: Max matches to return (default 5).

Get a categorised hours summary (worked, client, internal, holidays).

Args: period: Symbolic period — "this_month", "last_month", "this_week", "last_week". Affected by PRODUCTIVE_BILLING_CUTOFF_DAY. after: ISO date (YYYY-MM-DD). Ignored if period is set. before: ISO date (YYYY-MM-DD). Ignored if period is set. person: Person name, email, id, or "me" (default: "me"). project: Optional project name or id to scope the report.

Get a named employee's hours summary for a period.

Args: person: Person name, email, or "me" (fuzzy matched). period: Symbolic period — "this_month", "last_month", "this_week", "last_week". after: ISO date (YYYY-MM-DD). Ignored if period is set. before: ISO date (YYYY-MM-DD). Ignored if period is set.

List active projects where you have logged time in the last 30 days.

Returns project id, name, number, and company for each.

Get a summary of your week: projects touched, hours logged, recent entries.

Args: period: Symbolic period — defaults to "this_week". Also accepts "last_week", "this_month", "last_month".