Timely AI Agent
Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Timely MCP or direct API to log work hours, fetch activity timelines, generate productivity reports, and manage project timesheets through natural language.
Connect on Telegram
Timely is an automatic time-tracking platform that seamlessly records work across apps, calendars, and devices. It helps you create detailed timesheets and gain productivity insights without manual input.
▪ Tools & Triggers
Supported Tools and Triggers
Every Timely action and event your agent gets out of the box.
Create Client
Tool to create a new client in the specified Timely account. Use when adding a new client to track time against. Client names must be unique within an account.
Create Day Locking
Tool to create a day locking entry that prevents editing of time entries for specific dates and users. Use when you need to lock time entries to prevent modifications after approval or billing.
Create Label
Tool to create a new label in the specified Timely account. Use when you need to create a label for categorizing projects, time entries, or other resources.
Create report
Tool to generate reports for a Timely account with optional filters. Use when you need to create reports for time tracking, billing analysis, or project summaries with date range or user/project filters.
Create Team
Tool to create a new team in the specified Timely account. Use when organizing users into teams for better collaboration and project management.
Create Webhook
Tool to create a new webhook for the specified account. Use after specifying the target URL and event subscriptions. Call only once per configuration.
Delete a label
Tool to delete a label by ID from a Timely account. Use when you need to remove an existing label.
Delete a team
Tool to delete a team by its ID. Use when you need to remove a specific team from the account. This operation is destructive and cannot be undone.
Delete Webhook
Tool to delete an existing webhook by its ID. Use when you need to remove a webhook subscription from an account.
Filter reports
Tool to filter Timely reports based on date range, users, projects, labels, teams, and billing status. Use when you need to generate custom reports with specific criteria or analyze time tracking data for specific periods or resources.
Get activities
Tool to retrieve all activities (audit trail) for a Timely account. Activities include logged hours, created reports, shared reports, project changes, and other account events. Use when you need to view the activity log or audit trail for an account.
Get Client
Tool to retrieve details of a specific client by its ID. Use when you need to fetch client information such as name, color, active status, or external references.
Get current user's permissions
Tool to retrieve the current user's permissions for a specified account. Use when you need to check what actions the authenticated user can perform.
Get current user
Tool to retrieve the currently authenticated user. Use when you need to get details of the logged-in user.
Retrieve a label
Tool to retrieve a label by ID from a Timely account. Use when you need to fetch label details such as name, color, and parent relationship.
Get project
Tool to retrieve a single project by its ID. Use when you need detailed information about a specific project, such as its name, budget, billable status, or associated client.
Retrieve a team
Tool to retrieve details of a specific team by its ID. Use when you need to fetch team information including name, color, and members.
Retrieve a user
Tool to retrieve a user by ID from a Timely account. Use when you need to fetch user details such as name, email, and avatar.
Get user capacities
Tool to retrieve capacity information for a specific user in a Timely account. Use when you need to check user work capacity or availability schedules.
Get user permissions
Tool to retrieve a user's permissions by their ID. Use when you need to check what permissions a specific user has in a Timely account.
Get Webhook
Tool to retrieve a specific webhook by its ID. Use when you need to check the configuration or status of an existing webhook.
List accounts
Retrieve all accessible Timely accounts for the authenticated user. Example: "List all Timely accounts"
List clients
Tool to list all clients in a Timely account with optional filtering and sorting. Use when you need to discover client IDs or names for project creation, reporting, or mapping external systems.
List events
Tool to list all events (time entries) in a Timely account with optional filtering by date range, users, and projects. Use when you need to retrieve time entries for reporting, analysis, or synchronization with external systems.
List forecasts
Tool to list all forecasts (tasks) in a Timely account with optional date filtering. Use when you need to view planned tasks, retrieve forecast IDs, or analyze scheduled work.
List labels
Tool to list all labels in a Timely account. Use when you need to discover label IDs or names for organizing projects and time entries. Can optionally filter to show only child labels by providing a parent_id.
List project events
Tool to list all events (time entries) for a specific project in Timely. Use when you need to retrieve all time logs associated with a project for reporting, analysis, or verification.
List projects
Tool to list all projects in a Timely account with optional filtering and sorting. Use when you need to discover project IDs or names for time entry creation, reporting, or mapping external systems.
List roles
Tool to list all available roles in a Timely account. Use when you need to discover role IDs or names for user assignment or permission management.
List teams
Tool to list all teams in the specified Timely account. Use when you need to retrieve all teams for collaboration and project management purposes.
List user events
Tool to list all events (time entries) for a specific user in Timely. Use when you need to retrieve all time logs for a user for reporting, analysis, or verification.
List users
Tool to list all users in a Timely account with optional filtering and pagination. Use when you need to discover user IDs, names, or emails for time entry creation, reporting, or user management.
List Webhooks
Tool to list all webhooks in the specified account. Use when you need to see existing webhook configurations or verify webhook setup.
Process bulk events
Tool to create, update, or delete multiple events in a single bulk operation. Use when performing multiple event operations to improve efficiency. Supports up to 100 operations per request across create, update, and delete operations.
Retrieve an account
Tool to retrieve details of a specific account by its ID. Use when you need to fetch fresh account info after confirming the ID. Example: "Retrieve account details for account ID 364"
Update a client
Tool to update an existing client by ID in Timely. Use when you need to modify client details such as name, status, color, or external ID.
Update day locking settings
Tool to update day locking settings for specified users and dates. Use when you need to lock or unlock specific days for time tracking. Locked days prevent users from editing time entries on those dates.
Update a label
Tool to update a label by ID in a Timely account. Use when you need to modify an existing label's name, color, or hierarchy.
Update a project
Tool to update a project by ID in a Timely account. Use when you need to modify project details such as name, description, billing status, or archive a project.
Update a user
Tool to update a user by ID in a Timely account. Use when you need to modify user details such as email, name, role, or status.
Update Webhook
Tool to update an existing webhook by ID. Use when you need to modify webhook settings such as URL, subscriptions, or active status.
No matches.
Put Timely on autopilot
Connect Timely to your TeleClaw agent and run these 41 tools straight from Telegram.
Get started free