delete_forecast
Delete Forecast
Call list_accounts to choose a workspace when needed. Permanently delete a forecast (planned task) from Timely. This cannot be undone.
Ask your agent in plain language. Each of these maps to a real tool on the server.
delete_forecast
Call list_accounts to choose a workspace when needed. Permanently delete a forecast (planned task) from Timely. This cannot be undone.
create_project
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. Update an existing time entry in Timely. Modify the duration, date, project, notes, labels, billing status, or hourly rate.
list_teams
Call list_accounts to choose a workspace when needed. Retrieve teams from Timely, including their members and lead assignments.
get_report
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. Retrieve account (workspace) details from Timely including plan info, currency, capacity settings, user counts, and feature flags.
delete_project
Call list_accounts to choose a workspace when needed. Permanently delete a project from Timely. This cannot be undone. Consider archiving (via Update Project with active=false) instead.
list_forecasts
Call list_accounts to choose a workspace when needed. Retrieve forecasts (planned tasks) from Timely. Filter by date range, project, or user. Compare planned vs. actual logged time.
manage_label
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. Permanently delete a team from Timely. This removes the team but does not remove its members from the account.
manage_forecast
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. Log a new time entry in Timely. Specify duration via hours/minutes or a from/to time range. Provide a project ID; optionally add notes, labels, and set an hourly rate.
delete_label
Call list_accounts to choose a workspace when needed. Permanently delete a label from Timely. This cannot be undone. Consider archiving (via Manage Label with active=false) instead.
list_projects
Call list_accounts to choose a workspace when needed. Retrieve projects from Timely. Filter by status (active, archived, all, mine). Includes client, budget, and rate information.
list_users
Call list_accounts to choose a workspace when needed. Retrieve users from the Timely workspace. Includes roles, capacity, and rate information. Filter the returned page by status (active, archived, all).
manage_client
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. 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
Call list_accounts to choose a workspace when needed. Permanently delete a time entry from Timely. This cannot be undone.
list_labels
Call list_accounts to choose a workspace when needed. Retrieve labels (tags) from Timely. Labels support a hierarchical parent/child structure and are used to classify work on time entries.
list_clients
Call list_accounts to choose a workspace when needed. Retrieve clients from Timely. Filter by status (active, archived, all). Clients represent the companies or entities you work for.
list_time_entries
Call list_accounts to choose a workspace when needed. Retrieve time entries (events) from Timely. Filter by date range, specific date, user, or project. Supports pagination for large result sets.
get_time_entry
Retrieve one Timely time entry by ID, including its project, user, duration, and billing state. Call list_accounts to discover workspace IDs.
get_current_user
Retrieve your Timely identity, role, and capacity in a workspace. Call list_accounts to discover workspace IDs.
list_accounts
List Timely workspaces available to the authenticated user. Pass a returned accountId to other tools to choose a workspace.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Discover workspaces and your current user profile. Track and manage time entries, timers, projects, budgets, clients, labels, teams, forecasts, day locks, and filtered time reports. Workspace permissions and plan features determine available operations.
Common questions about connecting Timely to AI agents with Metorial.