Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Clio

Scalekit connector
Open markdown

The Clio connector lets your AI agent act in each user's Clio account. Each user signs in to Clio once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 30 tools.

Tools
30
What they doRead · write · destructive
15 · 11 · 415 read11 write4 destructive
Users sign in with
OAuth app
Your own Clio app

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Clio connection

    In AgentKit > Connections, create a Clio connection and copy its redirect URI. The name you give it is the connection_name your code passes. See Configure connections.

  4. Register an OAuth app

    Clio connections use your own OAuth app. Register one with Clio and add the redirect URI you copied.

    Then enter the app's Client ID and Client Secret on the Clio connection.

  5. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'clio'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Clio:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'clio_activities_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • clio_activities_listList time and expense entries, filtered by matter, user, type, status, date range or a search on the note.Read-only

    List Activities

    List time and expense entries, filtered by matter, user, type, status, date range or a search on the note. Returns data[] of activities (type, date, hours, price, total, note, billed state, matter, user) and meta.paging. Use clio_activities_list to review billable work. Use clio_activity_create to log time or an expense.

    Inputs

    end_datestring
    Entries dated on or before this date (YYYY-MM-DD). Example: 2026-11-30
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,type,date,quantity_in_hours,price,total,note,billed,non_billable,matter{id,display_number},user{id,name},activity_description{id,name},created_at,updated_atdefault id,etag,type,date,quantity_in_hours,price,total,note,billed,non_billable,matter{id,display_number},user{id,name},activity_description{id,name},created_at,updated_at
    limitinteger
    Records per page, 1-200 (default 200). Example: 50
    matter_idinteger
    Only entries on this matter. Example: 1234567
    orderstring
    Sort order, such as date(desc), id(asc) or total(desc). Example: date(desc)
    page_tokenstring
    Token for the next page, taken from meta.paging.next in the previous response. Example: BAh7BjoLb2Zmc2V0aQH6
    querystring
    Wildcard search over the entry note. Example: research
    start_datestring
    Entries dated on or after this date (YYYY-MM-DD). Example: 2026-11-01
    statusstring
    billed, draft, unbilled, non_billable, billable or written_off. Example: unbilledone of billeddraftunbillednon_billablebillablewritten_off
    typestring
    TimeEntry, ExpenseEntry, HardCostEntry, SoftCostEntry or FixedFee. Example: TimeEntryone of TimeEntryExpenseEntryHardCostEntrySoftCostEntryFixedFee
    user_idinteger
    Only entries by this user. Example: 345678
  • clio_bill_getGet one bill.Read-only

    Get Bill

    Get one bill. Returns data with the requested bill fields. Use clio_bill_get when you know the bill ID. Use clio_bills_list to search.

    Inputs

    bill_idintegerrequired
    ID of the bill. Example: 1234567
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,number,state,kind,issued_at,due_at,total,paid,balance,due,subject,client{id,name},matters{id,display_number},created_at,updated_atdefault id,etag,number,state,kind,issued_at,due_at,total,paid,balance,due,subject,client{id,name},matters{id,display_number},created_at,updated_at
  • clio_bills_listList bills (invoices), filtered by client, matter, state, overdue status or issue and due dates.Read-only

    List Bills

    List bills (invoices), filtered by client, matter, state, overdue status or issue and due dates. Returns data[] of bills (number, state, issued and due dates, total, paid, balance, client, matters) and meta.paging. Use clio_bills_list to check invoices and balances. Use clio_bill_get for one bill.

    Inputs

    client_idinteger
    Only bills for this client contact. Example: 1234568
    due_beforestring
    Due before this date (YYYY-MM-DD). Example: 2026-12-01
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,number,state,kind,issued_at,due_at,total,paid,balance,due,subject,client{id,name},matters{id,display_number},created_at,updated_atdefault id,etag,number,state,kind,issued_at,due_at,total,paid,balance,due,subject,client{id,name},matters{id,display_number},created_at,updated_at
    issued_afterstring
    Issued after this date (YYYY-MM-DD). Example: 2026-10-01
    limitinteger
    Records per page, 1-200 (default 200). Example: 50
    matter_idinteger
    Only bills for this matter. Example: 1234567
    overdue_onlyboolean
    Only overdue bills. Example: true
    page_tokenstring
    Token for the next page, taken from meta.paging.next in the previous response. Example: BAh7BjoLb2Zmc2V0aQH6
    statestring
    draft, awaiting_approval, awaiting_payment, paid, void or deleted. Example: awaiting_paymentone of draftawaiting_approvalawaiting_paymentpaidvoiddeleted
  • clio_calendar_entries_listList calendar entries in a time range, optionally for one calendar or matter, with recurring events expanded.Read-only

    List Calendar Entries

    List calendar entries in a time range, optionally for one calendar or matter, with recurring events expanded. Returns data[] of entries (summary, start_at, end_at, all_day, location, matter, calendar owner) and meta.paging. Use clio_calendar_entries_list to check a schedule. Use clio_calendar_entry_create to add an event.

    Inputs

    calendar_idinteger
    Only entries on this calendar. Example: 456789
    expandedboolean
    Return each occurrence of recurring events. Example: true
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,summary,description,location,start_at,end_at,all_day,recurrence_rule,matter{id,display_number},calendar_owner{id,name},created_at,updated_atdefault id,etag,summary,description,location,start_at,end_at,all_day,recurrence_rule,matter{id,display_number},calendar_owner{id,name},created_at,updated_at
    fromstring
    Entries ending on or after this ISO-8601 time. Example: 2026-11-15T00:00:00Z
    limitinteger
    Records per page, 1-200 (default 200). Example: 50
    matter_idinteger
    Only entries for this matter. Example: 1234567
    page_tokenstring
    Token for the next page, taken from meta.paging.next in the previous response. Example: BAh7BjoLb2Zmc2V0aQH6
    querystring
    Wildcard search over calendar entries. Example: hearing
    tostring
    Entries starting on or before this ISO-8601 time. Example: 2026-11-22T23:59:59Z
  • clio_calendars_listList calendars the connected user can see.Read-only

    List Calendars

    List calendars the connected user can see. Returns data[] of calendars with id, name, type (UserCalendar, AccountCalendar, AdhocCalendar), permission and visibility. Use clio_calendars_list to get the calendar ID needed by clio_calendar_entry_create.

    Inputs

    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,name,type,permission,visible,colordefault id,etag,name,type,permission,visible,color
    limitinteger
    Records per page, 1-200 (default 200). Example: 50
    ownerboolean
    Only calendars the user owns. Example: true
    page_tokenstring
    Token for the next page, taken from meta.paging.next in the previous response. Example: BAh7BjoLb2Zmc2V0aQH6
    typestring
    AccountCalendar, AdhocCalendar or UserCalendar. Example: UserCalendarone of AccountCalendarAdhocCalendarUserCalendar
    writeableboolean
    Only calendars the user can write to. Example: true
  • clio_communications_listList logged emails and phone calls, filtered by matter, contact, user, type, date range or a search string.Read-only

    List Communications

    List logged emails and phone calls, filtered by matter, contact, user, type, date range or a search string. Returns data[] of communications (type, subject, body, received_at, matter, senders, receivers) and meta.paging. Use clio_communications_list to review client correspondence. Use clio_communication_create to log a call or email.

    Inputs

    contact_idinteger
    Only communications with this contact. Example: 1234568
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,type,subject,body,date,received_at,matter{id,display_number},user{id,name},senders{id,name,type},receivers{id,name,type},created_at,updated_atdefault id,etag,type,subject,body,date,received_at,matter{id,display_number},user{id,name},senders{id,name,type},receivers{id,name,type},created_at,updated_at
    limitinteger
    Records per page, 1-200 (default 200). Example: 50
    matter_idinteger
    Only communications on this matter. Example: 1234567
    page_tokenstring
    Token for the next page, taken from meta.paging.next in the previous response. Example: BAh7BjoLb2Zmc2V0aQH6
    querystring
    Wildcard search over communication body and subject. Example: settlement
    received_beforestring
    On or before this date (ISO-8601). Example: 2026-11-30
    received_sincestring
    On or after this date (ISO-8601). Example: 2026-11-01
    typestring
    EmailCommunication or PhoneCommunication. Example: PhoneCommunicationone of EmailCommunicationPhoneCommunication
  • clio_contact_getGet one contact.Read-only

    Get Contact

    Get one contact. Returns data with the requested contact fields. Use clio_contact_get when you know the contact ID. Use clio_contacts_list to search.

    Inputs

    contact_idintegerrequired
    ID of the contact. Example: 1234567
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,name,first_name,last_name,type,title,primary_email_address,primary_phone_number,is_client,company{id,name},created_at,updated_atdefault id,etag,name,first_name,last_name,type,title,primary_email_address,primary_phone_number,is_client,company{id,name},created_at,updated_at
  • clio_contacts_listList people and companies in Clio, filtered by a search string, type, client flag or update time.Read-only

    List Contacts

    List people and companies in Clio, filtered by a search string, type, client flag or update time. Returns data[] of contacts (name, type, primary email and phone, is_client, company) and meta.paging. Use clio_contacts_list to find a contact or client. Use clio_contact_get for one contact by ID.

    Inputs

    client_onlyboolean
    Only contacts that are clients. Example: true
    fieldsstring
    Comma-separated fields to return; nested records use braces. Clio returns only id and etag when fields is empty, so a useful default is set. Example: id,etag,name,first_name,last_name,type,title,primary_email_address,primary_phone_number,is_client,company{id,name},created_at,updated_atdefault id,etag,name,first_name,last_name,type,title,primary_email_address,primary_phone_number,is_client,company{id,name},created_at,updated_at
    limitinteger
    Records per page, 1-200 (default 200). Example: 50
    orderstring
    id(asc), id(desc), name(asc) or name(desc). Example: name(asc)one of id(asc)id(desc)name(asc)name(desc)shared_at(asc)shared_at(desc)
    page_tokenstring
    Token for the next page, taken from meta.paging.next in the previous response. Example: BAh7BjoLb2Zmc2V0aQH6
    querystring
    Wildcard search over name, title, email, address, phone, web site, custom fields and related matter. Example: Smith
    typestring
    Person or Company. Example: Personone of PersonCompany
    updated_sincestring
    Only records updated after this ISO-8601 time. Example: 2026-11-01T00:00:00Z