categorization_context
ChatGPTUse this only when the user asks for help categorizing their activities. Returns personal context: occupation, job title, industry and company name when set, and up to 50 activities the user has categorized themselves. Use it only to suggest categories; do not repeat or store it for any other purpose.
categorize_uncategorized_activities
ChatGPTUse this only after the user explicitly approves categories for activities that are currently Uncategorized. First propose the assignments (activity and category) and get the user's approval; do not infer approval from a request for suggestions. Only Uncategorized activities change; any other activity is rejected, and one already in the requested category is reported unchanged. Only the category is assigned; the activity then uses the category's productivity score. Undo with recategorize_activities and reset_to_default.
get_focus_state
ChatGPTReturns whether the user is currently in a focus zone, focus session, or timer, including timing, blocking, and linked project context.
list_categories
ChatGPTUse this when the user wants to see or choose among their categories, including ones they created, for example before proposing categories for Uncategorized activities. Returns each category id, its overview and the productivity score that applies to it for this user.
list_clients
ChatGPTUse this when the user needs client ids or names for timesheet questions or report filters. mode is required: 'personal' lists the clients the caller can log time against, their own and the team clients assigned to them; 'team' lists every team client assigned to the teams or members the caller manages, with the assigned teams, and requires a manager, administrator or owner role. Each client carries its active projects.
list_projects
ChatGPTUse this when the user needs project ids or names for timesheet questions, report filters or focus sessions. mode is required: 'personal' lists the projects the caller can log time against, their own and the team projects assigned to them; 'team' lists every team project assigned to the teams or members the caller manages, with the assigned teams, and requires a manager, administrator or owner role. Each project carries its client and its active tasks.
list_tasks
ChatGPTUse this when the user needs task ids or names for timesheet questions, report filters or focus sessions. mode is required: 'personal' lists the tasks the caller can log time against, their own and the team tasks assigned to them; 'team' lists every team task assigned to the teams or members the caller manages, with the assigned teams, and requires a manager, administrator or owner role. Each task carries the active projects it belongs to. Time logged with no task is reported without a task, not as one.
project_time_history
ChatGPTReturns the authenticated user's project-time blocks within a date range, including user-owned and available team projects, tasks, clients, and review state.
recategorize_activities
ChatGPTUse this only after the user explicitly names activities and asks to change their category, or to undo a categorization. Propose the change and get the user's approval first. Activities are matched by exact name (case-insensitive) among those logged in the last 45 days; a name that is not found or matches more than one activity is reported, never guessed. Only the category is assigned; the activity then uses the category's productivity score. reset_to_default removes the user's own category so RescueTime's default applies; it is the undo for both categorization tools. Each result returns the previous category: when previous_was_override is false, undo with reset_to_default, otherwise with that category id.
recent_activity
ChatGPTReturns recent logged applications/sites with category and productivity context. Day chunks use five-minute intervals; week chunks use hourly intervals.
reference_documentation
ChatGPTReads public RescueTime taxonomy, productivity, overview, or category definitions. No authentication is required.
start_focus_session
ChatGPTStarts a focus session for the authenticated user. Call get_focus_state first and use only after the user explicitly asks to start a session.
start_timer
ChatGPTStarts a project-aware timer for the authenticated user. Call get_focus_state first and use only after the user explicitly asks to start a timer.
stop_focus
ChatGPTStops the active focus session or timer. Pass the start epoch returned by get_focus_state and use only after the user explicitly asks to stop it.
taxonomy_rollup
ChatGPTRolls up tracked time by activity, category, overview, or productivity for a bounded date range.
timesheet_report
ChatGPTUse this when the user asks how much time went to clients, projects or tasks, for status reports, billing, utilization or any other timesheet summary. It is the timesheet tool to try first: it returns totals already filtered and grouped by client, project or task, per day, week, month or for the whole range, the way the web timesheet report does. mode is required: 'personal' totals the caller's own time; 'team' totals other users' time on team projects, tasks and clients across the teams the caller manages, grouped by user and/or team. Totals count reviewed blocks; unreviewed draft time is reported separately as unreviewed_seconds. A task_ids filter also counts time logged with no task, and a client_ids filter also counts time on projects with no client, as the web report does by default; pass include_no_task or include_no_client as false to count only the listed ones. The result says which applied. Billable fields appear only when the caller may see rates. Use project_time_history only when a question needs the individual blocks in time order or a regrouping these totals cannot give.
uncategorized_activities
ChatGPTUse this when the user wants to find or fix activities RescueTime has not categorized (Uncategorized). Returns them ranked by time with an entity_id for each, their first and last dates, and up to three document or page titles as context for suggesting a category.