Is timely safe to install?

SaferSkills independently audited timely (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

clawhub-skills/timely/SKILL.md · 1 file

clawhub-skills/timely/SKILL.md9.4 KB · Markdown

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

List your accounts: timely_list_accounts -- discover your Timely account IDs.
List projects: timely_list_projects -- see all active projects with budgets.
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

Call clawlink_list_integrations to confirm timely is connected.
Call clawlink_list_tools --integration timely to see the live catalog.
Call timely_list_accounts to get your account ID.
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](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=timely) -- an integration hub for OpenClaw

timely— agent skill

Is timely safe to install?

Timely

Setup in 3 Steps

How It Works

Install

Quick Start

Authentication

Connection Management

Security & Permissions

Tool Reference

Account Operations

Project Operations

Time Entry / Event Operations

Client Operations

Report Operations

Team Operations

User Operations

Label Operations

Forecast Operations

Day Locking Operations

Webhook Operations

Activity / Role Operations

Code Examples

Discovery Workflow

Execution Workflow

Notes

Error Handling

Troubleshooting

Tools Not Visible

Invalid Tool Call

Resources

Audit the pieces. Scan the whole. Decide.