delete_forecast
Delete Forecast
Permanently delete a forecast (planned task) from Timely. This cannot be undone.
delete_forecast
Permanently delete a forecast (planned task) from Timely. This cannot be undone.
create_project
Create a new project in Timely. Configure client, billing, budget, hourly rate, label settings, team assignments, and user assignments with individual rates.
update_time_entry
Update an existing time entry in Timely. Modify the duration, date, project, notes, labels, billing status, or hourly rate.
list_teams
Retrieve teams from Timely, including their members and lead assignments.
get_report
Generate a filtered time report from Timely. Filter by date range, users, projects, labels, and teams. Group results by clients, users, labels, days, or teams for aggregated metrics including duration, cost, profit, and profitability.
manage_day_lock
Lock or unlock specific dates for specific users in Timely. Locking prevents accidental changes or unauthorized edits to time records for those days.
get_account
Retrieve account (workspace) details from Timely including plan info, currency, capacity settings, user counts, and feature flags.
delete_project
Permanently delete a project from Timely. This cannot be undone. Consider archiving (via Update Project with active=false) instead.
list_forecasts
Retrieve forecasts (planned tasks) from Timely. Filter by date range, project, or user. Compare planned vs. actual logged time.
manage_label
Create or update a label (tag) in Timely. Provide a **labelId** to update an existing label, or omit it to create a new one. Labels can have a parent for hierarchical organization.
manage_timer
Start or stop a timer on an existing time entry for real-time time tracking. Use **start** to begin tracking and **stop** to end it.
update_project
Update an existing project in Timely. Modify name, description, client, billing, budget, rates, label settings, team assignments, user assignments, or archive/unarchive it.
delete_team
Permanently delete a team from Timely. This removes the team but does not remove its members from the account.
manage_forecast
Create or update a forecast (planned task) in Timely. Provide a **forecastId** to update, or omit it to create a new one. Forecasts help plan upcoming work with estimated times and assigned users.
create_time_entry
Log a new time entry in Timely. Specify duration via hours/minutes or a from/to time range. Optionally assign to a project, add notes, labels, and set an hourly rate.
delete_label
Permanently delete a label from Timely. This cannot be undone. Consider archiving (via Manage Label with active=false) instead.
list_projects
Retrieve projects from Timely. Filter by status (active, archived, all, mine). Includes client, budget, and rate information.
list_users
Retrieve users from the Timely workspace. Includes roles, capacity, and rate information. Filter by status (active, archived, all).
manage_client
Create or update a client in Timely. Provide a **clientId** to update an existing client, or omit it to create a new one. Set **active** to false to archive a client.
manage_team
Create or update a team in Timely. Provide a **teamId** to update an existing team, or omit it to create a new one.
delete_time_entry
Permanently delete a time entry from Timely. This cannot be undone.
list_labels
Retrieve labels (tags) from Timely. Labels support a hierarchical parent/child structure and are used to classify work on time entries.
list_clients
Retrieve clients from Timely. Filter by status (active, archived, all). Clients represent the companies or entities you work for.
list_time_entries
Retrieve time entries (events) from Timely. Filter by date range, specific date, user, or project. Supports pagination for large result sets.
Track and manage time entries for projects, clients, and team members. Create, update, and delete time entries (events) with hours, notes, labels, and billing status. Manage projects with budgets, hourly rates, and user assignments. Create and organize clients, labels (tags), and teams. Plan upcoming work with task forecasts. Start and stop real-time timers. Lock days to prevent unauthorized edits. Generate reports filtered by date range, users, projects, labels, and teams with metrics for duration, cost, profit, and profitability. Manage user roles, permissions, and capacity settings. Configure webhooks for real-time notifications on time entries, projects, labels, and forecasts.
Common questions about connecting Timely to AI agents with Metorial.