timely

name	timely
description	Timely API integration with managed OAuth. Track time entries, manage projects, generate reports, manage clients and teams. Use this skill when users want to track work hours, review time tracking reports, manage project budgets, or analyze team productivity.

Timely

Automatic time tracking from chat -- manage time entries, projects, clients, teams, and generate detailed reports.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted OAuth flows and credentials so you don't need to configure Timely API access yourself.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Timely
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Timely

How It Works

┌─────────────────┐     ┌──────────────┐     ┌──────────────────┐
│   OpenClaw      │────▶│   ClawLink   │────▶│   Timely API     │
│   (User Chat)   │     │   (OAuth)    │     │                  │
└─────────────────┘     └──────────────┘     └──────────────────┘

Install

openclaw plugins install clawhub:clawlink-plugin
openclaw config set tools.alsoAllow '["clawlink-plugin"]' --strict-json
openclaw gateway restart

Quick Start

1. List your accounts: timely_list_accounts -- discover your Timely account IDs.
2. List projects: timely_list_projects -- see all active projects with budgets.
3. Generate a report: timely_create_report -- create time tracking reports with filters.

Authentication

Timely uses managed OAuth via ClawLink. No API keys needed. Connect your Timely account at claw-link.dev/dashboard?add=timely and authorize access through the hosted flow.

Connection Management

List connections: clawlink_list_integrations -- confirm Timely is connected.

Verify: Call timely_list_accounts to test access.

Reconnect: If you see auth errors, reconnect at claw-link.dev/dashboard?add=timely.

Security & Permissions

Read operations (list events, get reports) run safely without confirmation. Write operations (create, update, delete) require confirmation. Delete operations are marked as high-impact and irreversible.

Tool Reference

Account Operations

Tool	Description	Mode
timely_list_accounts	List all accessible Timely accounts	Read
timely_retrieve_account	Get details of a specific account by ID	Read

Project Operations

Tool	Description	Mode
timely_list_projects	List all projects with optional filtering and sorting	Read
timely_get_project	Retrieve a single project by ID	Read
timely_update_project	Update project name, description, billing, or archive	Write

Time Entry / Event Operations

Tool	Description	Mode
timely_list_events	List all time entries with date, user, and project filters	Read
timely_list_project_events	List time entries for a specific project	Read
timely_list_user_events	List time entries for a specific user	Read
timely_process_bulk_events	Bulk create, update, or delete up to 100 events	Write

Client Operations

Tool	Description	Mode
timely_list_clients	List all clients with optional filtering	Read
timely_get_client	Get details of a specific client by ID	Read
timely_create_client	Create a new client (names must be unique)	Write
timely_update_client	Update client details by ID	Write

Report Operations

Tool	Description	Mode
timely_create_report	Generate reports with optional date and project filters	Read
timely_filter_reports	Filter reports by date, users, projects, labels, teams	Read

Team Operations

Tool	Description	Mode
timely_list_teams	List all teams in the account	Read
timely_get_team	Get details of a specific team by ID	Read
timely_create_team	Create a new team	Write
timely_delete_team	Permanently delete a team	Write

User Operations

Tool	Description	Mode
timely_list_users	List all users with optional filtering and pagination	Read
timely_get_user	Get details of a specific user by ID	Read
timely_get_current_user	Get the currently authenticated user	Read
timely_get_current_permissions	Get the current user's permissions	Read
timely_get_user_permissions	Get a user's permissions by ID	Read
timely_get_user_capacities	Get capacity information for a user	Read
timely_update_user	Update user details (email, name, role, status)	Write

Label Operations

Tool	Description	Mode
timely_list_labels	List all labels with optional parent filtering	Read
timely_get_label	Get details of a specific label by ID	Read
timely_create_label	Create a new label for categorization	Write
timely_update_label	Update label name, color, or hierarchy	Write
timely_delete_label	Permanently delete a label	Write

Forecast Operations

Tool	Description	Mode
timely_list_forecasts	List all forecasts (planned tasks) with date filtering	Read

Day Locking Operations

Tool	Description	Mode
timely_create_day_locking	Lock time entries for specific dates and users	Write
timely_update_day_locking	Update day locking settings	Write

Webhook Operations

Tool	Description	Mode
timely_list_webhooks	List all webhooks for the account	Read
timely_get_webhook	Get details of a specific webhook	Read
timely_create_webhook	Create a new webhook subscription	Write
timely_update_webhook	Update an existing webhook	Write
timely_delete_webhook	Permanently delete a webhook	Write

Activity / Role Operations

Tool	Description	Mode
timely_get_activities	Retrieve audit trail of account events	Read
timely_list_roles	List all available roles in the account	Read

Code Examples

List accounts and projects

{ "tool": "timely_list_accounts" }

{
  "tool": "timely_list_projects",
  "args": { "account_id": "364" }
}

Generate a filtered report

{
  "tool": "timely_filter_reports",
  "args": {
    "account_id": "364",
    "since": "2026-06-01",
    "until": "2026-06-07"
  }
}

List time entries for a project

{
  "tool": "timely_list_project_events",
  "args": {
    "account_id": "364",
    "project_id": "1234"
  }
}

Discovery Workflow

1. Call clawlink_list_integrations to confirm timely is connected.
2. Call clawlink_list_tools --integration timely to see the live catalog.
3. Call timely_list_accounts to get your account ID.
4. Use the account ID for all subsequent operations.

Execution Workflow

Read Flow:  User asks for time data → clawlink resolves connection → Timely API → results displayed
Write Flow: User wants to create entry → confirmation prompt → clawlink resolves connection → Timely API → result confirmed

Notes

• Most operations require an account_id. Always start with timely_list_accounts.
• Client names must be unique within an account.
• timely_process_bulk_events supports up to 100 operations per request.
• timely_get_activities provides an audit trail including logged hours and project changes.

Error Handling

Status / Error	Meaning
401 Unauthorized	Token expired; reconnect at the dashboard
404 Not Found	Invalid account, project, or user ID
422 Unprocessable	Duplicate client name or invalid parameters

Troubleshooting

Tools Not Visible

Run openclaw gateway restart after installing the plugin. Start a fresh chat session.

Invalid Tool Call

Ensure you are passing the correct account_id parameter. Use timely_list_accounts to discover it.

Resources

• Timely API Docs: https://dev.timelyapp.com
• ClawLink: https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=timely
• ClawLink Docs: https://docs.claw-link.dev/openclaw

---

Powered by ClawLink -- an integration hub for OpenClaw