---
title: "Timely integration for LuumenAI"
url: "https://www.luumen.ai/integrations/timely/"
entity: SoftwareIntegration
category: "Project management"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Timely integration for LuumenAI

Read Timely timesheets for context, then lock or adjust periods with approval

## What LuumenAI can do with Timely

LuumenAI connects to Timely with OAuth 2.0 and exposes 41 tools (26 read-only · 11 write · 4 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: OAuth 2.0
- Tools available: 41 tools (26 read-only · 11 write · 4 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Project management

## About Timely with LuumenAI

Connect Timely and the agent can read your account the way you would: timesheets, projects, clients, labels, teams, user capacities, permissions, and the activity audit trail. Ask what a person logged last week or which projects carry unbilled hours, and you get an answer. Changes like locking a closed month or renaming a billing label are previewed first, then applied on your approval.

## Example tools

Read-only (26 in total):

- `TIMELY_CREATE_REPORT` — Generate reports for a Timely account with optional filters.
- `TIMELY_FILTER_REPORTS` — Filter Timely reports based on date range, users, projects, labels, teams, and billing status.
- `TIMELY_GET_ACTIVITIES` — Retrieve all activities (audit trail) for a Timely account.
- `TIMELY_GET_CLIENT` — Retrieve details of a specific client by its ID.
- `TIMELY_GET_CURRENT_PERMISSIONS` — Retrieve the current user's permissions for a specified account.
- `TIMELY_GET_CURRENT_USER` — Retrieve the currently authenticated user.
- `TIMELY_GET_LABEL` — Retrieve a label by ID from a Timely account.
- `TIMELY_GET_PROJECT` — Retrieve a single project by its ID.

Write and destructive (15 in total, subject to configured approval policy):

- `TIMELY_CREATE_CLIENT` — Create a new client in the specified Timely account.
- `TIMELY_CREATE_DAY_LOCKING` — Create a day locking entry that prevents editing of time entries for specific dates and users.
- `TIMELY_CREATE_LABEL` — Create a new label in the specified Timely account.
- `TIMELY_CREATE_TEAM` — Create a new team in the specified Timely account.
- `TIMELY_CREATE_WEBHOOK` — Create a new webhook for the specified account.
- `TIMELY_DELETE_LABEL` — Delete a label by ID from a Timely account.
- `TIMELY_DELETE_TEAM` — Delete a team by its ID.
- `TIMELY_DELETE_WEBHOOK` — Delete an existing webhook by its ID.

## Frequently asked questions

### How does LuumenAI connect to Timely?

Authorize once with OAuth 2.0. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Timely on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Timely — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/timely/