| name | Clio Time & Billing |
| description | Use this skill when logging time or expense activities against a Clio matter, or when reading (not writing) bills. Covers the activities domain's create-only lifecycle, the billing-read/time-entry-write split, and why billing mutations are out of scope for v1.
|
| when_to_use | When logging a time entry, logging an expense, or looking up bill status in Clio. Use when: clio time entry, clio activity, clio billable hours, clio expense, clio bill, clio invoice, clio billing, or clio log time. |
Clio Time & Billing
Overview
Clio splits billing-adjacent work into two domains with very different
permissions, and the split is deliberate:
| Domain | Tools | Can you write? |
|---|
| activities | clio_activities_list, clio_activities_get, clio_activities_create | Create only — no update, no delete |
| bills | clio_bills_list, clio_bills_get | Read-only |
Both domains reference matter_id — activities are logged against a
matter, and bills are generated from a matter's unbilled activities. See
the api-patterns skill for the full
matters-as-hub picture.
Activities: Time and Expense Entries
An activity is either a time entry or an expense entry logged against
a matter. Typical fields:
matter_id — the matter the activity belongs to (required)- Type — time entry vs. expense entry
- Description — what the work/expense was
- Quantity — for time entries, the duration; for expense entries, the
amount or unit count
- Rate — billing rate applied (time entries) or unit cost (expenses)
- Date — when the work/expense occurred
- Billable / non-billable flag
Logging Time
Use clio_activities_create with matter_id, a description, and the time
quantity. Before creating:
- Resolve the matter first — don't create a time entry against a
guessed or partially-matched matter. If the user names a client but not
a specific matter, and the client has multiple matters, ask which one.
- Get the description right — time entry descriptions often end up on
client-facing invoices; write them the way the attorney would want a
client to read them, not as an internal shorthand, unless told
otherwise.
- Confirm billable status if it's ambiguous — defaulting non-billable
work to billable (or vice versa) has real revenue/client-relationship
consequences.
See /log-time for the command-level workflow.
Why No Update or Delete on Activities
Once created, an activity can't be modified or removed through this
integration. Corrections happen in Clio directly, which preserves Clio's
own edit history for what is, in most firms, a billing-relevant record.
If a user asks you to "fix" a time entry you just logged, say plainly that
correcting or removing it needs to happen in Clio — don't attempt a
workaround (e.g. creating an offsetting negative entry) without the user
explicitly asking for that specific approach.
Bills: Read-Only
clio_bills_list / clio_bills_get let you look up bill status, amounts,
and which matter a bill was generated from — but you cannot generate,
edit, void, or send a bill through this integration.
Why Billing Mutations Are Out of Scope for v1
Generating or modifying a bill correctly requires trust-accounting rigor
this integration doesn't attempt: IOLTA/trust compliance, correct
application of retainers, avoiding double-billing across overlapping
billing cycles, and firm-specific billing rules (flat fee vs. hourly vs.
contingency) that vary matter to matter. Getting this wrong isn't a
cosmetic bug — it's a compliance and client-trust problem. So v1 reads
bills for context (e.g. "has this matter been billed recently, and for
how much") and leaves all billing actions to Clio's own billing workflow,
where a human with full context runs it.
When a user asks you to "send an invoice" or "write off this bill,"
explain that billing actions aren't available through this integration
and point them to Clio directly.
Common Workflow: Time Entry Then Status Check
A typical flow: log time against a matter
(clio_activities_create), then later check whether that matter's
unbilled activity has made it onto a bill (clio_bills_list filtered by
matter_id). These are two separate, one-directional operations — there's
no tool that ties a specific activity to the bill it ended up on; you can
only observe bill-level totals and status.
Related Skills
- Clio API Patterns — connection, navigation, scope limits, and why the whole surface is conservative-by-design
- Clio Matters — the matter activities and bills are scoped to
- Clio Contacts — the client a bill is ultimately billed to
