How to integrate Clio Manage (US) MCP with Atomic Agent

Connect Atomic Agent to Clio Manage (US) MCP. List open matters for client smith, create invoice for matter 2024-045, and more using natural language, with authentication handled for you.

Clio Manage (US) logoClio Manage (US)
Oauth2

Clio Manage (US) is legal practice management for United States-region accounts on app.clio.com. Centralize clients, matters, calendars, tasks, time entries, and billing to run your firm efficiently.

93 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Clio Manage (US).

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Clio Manage (US) account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Clio Manage (US) with

How Atomic Agent connects to Clio Manage (US)

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Clio Manage (US) to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Clio Manage (US). It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Clio Manage (US) account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Clio Manage (US) MCP server, and what's possible with it?

The Clio Manage MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Clio Manage account. It provides structured and secure access to your contacts, matters, calendars, tasks, activities, bills, communications, and documents, so your agent can manage contacts, organize matters, schedule events, record work, and prepare case documents on your behalf.

  • Contact and matter management: Have your agent find or create people and companies, open matters for clients, add matter notes, and locate the newest matter linked to a client email.
  • Tasks and calendar planning: Let the agent create tasks, apply task template lists to matters, build custom calendars, and schedule calendar entries.
  • Time, expenses, and billing: Direct your agent to record time or expense activities, review existing activities, and find bills by client, matter, bill number, or state.
  • Case communications and notes: Instruct your agent to record phone calls or emails in Clio Manage and add notes to the relevant matter.
  • Documents and templates: Have your agent start document uploads, create matter folders, download documents, build document templates, and generate documents from those templates.

Use Clio Manage (US) from Atomic Agent

With your account connected, ask Atomic Agent to work with Clio Manage (US) in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Clio Manage (US) action and event your agent gets out of the box.

Assign Task Template List

Assign one Clio task template list to a matter, creating its tasks with assignee notifications disabled.

Create Activity

Create a Clio time or expense activity with Activities write permission.

Create Calendar

Create a Clio custom calendar.

Create Calendar Entry

Create a Clio calendar entry.

Create Communication

Record a phone or email communication in Clio.

Create Contact

Create a Clio person or company, including new email addresses and phone numbers.

Create Document Upload Initiation

Create only the Clio document record and signed-upload initiation.

Create Document Template

Upload one non-sensitive file directly to Clio's documented multipart route and create a document template suitable for START_DOCUMENT_FROM_TEMPLATE or GENERATE_DOCUMENT_FROM_TEMPLATE.

Create Matter

Create a Clio matter for a client.

Create Matter Folder

Create a subfolder inside a Clio Matter.

Create Matter Note

Create a note associated with a Clio Matter.

Create Task

Create a non-complete Clio task with assignee notifications disabled.

Create Non-Empty Task Template List

Create a Clio task-template list with one to ten private, non-cascading, plain-text task templates without reminders, and read it back to confirm the template count.

Delete Activity

Permanently delete one Clio activity by ID, including a time entry, expense entry, or fixed fee.

Delete Bill

Delete a Draft or Pending Approval bill after confirming its ID, number, ETag and state, with an ownership attestation and deletion confirmation.

Delete Calendar

Permanently delete one manually created Clio calendar after verifying it is an owner-controlled AdhocCalendar.

Delete Calendar Entry

Permanently delete a non-recurring Clio calendar entry or an explicitly scoped recurring occurrence, future sequence, or series.

Delete Communication

Permanently delete one recorded Clio communication after an exact-ID preflight and explicit confirmation.

Delete Contact

Permanently delete one Clio contact by ID.

Delete Document

Move a Clio document to trash after an exact ID-and-name preflight and explicit confirmation.

Delete Document Template

Permanently delete a Clio document template after an exact ID-and-filename preflight and explicit confirmation.

Delete Folder

Move a non-root, unlocked Clio folder to trash after an exact ID-and-name preflight and explicit confirmation.

Delete Matter

Permanently delete one Clio matter by ID.

Delete Note

Permanently delete one Clio note after an exact-ID preflight and explicit confirmation.

Delete Task

Permanently delete one Clio task by ID.

Delete Task Template List

Permanently delete a Clio task-template list after an exact ID-and-name preflight and explicit confirmation.

Download Document

Download the latest or a specified Clio document version as a managed file, up to 100 MB.

Find Bill

Find Clio bills by client, matter, bill number, and state, combining supplied criteria with AND; provide client_id, matter_id, or invoice_number, with state narrowing the lookup.

Find Company Contact

Find Clio company contacts by exact name and optional email, returning matches without choosing among duplicates.

Find Contact by Custom Field

Search Clio contacts by a validated active Contact custom field and typed value, reporting matches, duplicate ambiguity, and candidates with incomplete comparisons.

Find Matter

Find a matter by matter_id alone, or search by display_number, description, or client_reference, optionally narrowed by client_id and status.

Find Matter by Custom Field

Find matters by a validated Matter custom field and value, optionally filtering by client and status.

Find Newest Matter by Client Email

Find the newest matter for a contact matched by email, optionally filtered by status, using created_at and greatest ID as the tie-break; matching ignores case and surrounding ASCII whitespace.

Find or Create Company Contact

Find or create a Clio company contact by company name and email or a complete custom-field ID/value pair; when both are supplied, both must match.

Find or Create Matter

Find or create a matter using a required description, either client ID or email, and a client reference or complete custom-field ID/value pair.

Find or Create Person Contact

Find or create a Clio person contact by first and last name plus email or a complete custom-field ID/value pair, searching accessible contacts before creation and checking afterward for race conflicts.

Find Person Contact

Find Clio person contacts matching first and last name and optionally email, without choosing an arbitrary duplicate.

Find User

Find a Clio user by ID, email, or full name; email and name searches support enabled and co-counsel filters, scan ID-ascending pages, report multiple exact matches as ambiguous, and identify users whose fields prevented comparison.

Generate Document From Template

Create a persistent Clio document automation from a template and poll its status within a bounded interval and timeout, requiring Documents read/write access and access to the Matter and template.

Get Activity

Get one Clio time or expense activity by ID, including billing state and its user and matter references.

Get Bill

Get one Clio bill with its ETag and lifecycle state, along with available state transitions and financial totals when provided.

Get Calendar

Get one Clio calendar by ID, including its type, permission, visibility, source, and colors.

Get Calendar Entry

Get one Clio calendar entry or expanded recurring occurrence by ID with recurrence, attendee, owner, and matter details.

Get Communication

Retrieve one recorded Clio communication.

Get Contact

Get one Clio person or company by its known ID, including primary and structured email and phone details.

Get Current User

Return the authenticated Clio user and role information for identity checks and default user references.

Get Document

Get one Clio document and its latest-version metadata by ID; requires Documents read permission.

Get Folder

Retrieve one Clio folder by ID.

Get Matter

Get one Clio matter by ID with lifecycle, client, staffing, practice area, dates, and billing method.

Get Matter Client

Retrieve the client contact for one Clio matter.

Get Note

Retrieve one Clio matter or contact note.

Get Task

Get one Clio task by its known ID, including description, status, due date, priority, one assignee, matter, and completion-notification state; tasks with multiple firm-user assignees return only one of them.

Get User

Get one Clio firm user by ID with identity, account role, locale, time zone, and default calendar information.

List Activity Descriptions

List selectable Clio activity descriptions and resolved rates for time entries.

List Calendars

List visible or writable Clio calendars to resolve the owner ID for calendar entries.

List Communications

Return one bounded page of recorded Clio email or phone communications.

List Contact Email Addresses

Return one bounded page of email addresses for a Clio contact.

List Contact Phone Numbers

Return one bounded page of phone numbers for a Clio contact.

List Document Automations

Return one bounded page of Clio document-generation automations.

List Documents

Return one bounded provider page of Clio documents.

List Document Templates

List Clio document templates and IDs for document automation.

List Expense Categories

List selectable Clio expense categories and rates for expense entries.

List Folder Contents

Return one bounded page of Clio documents and folders, optionally below a parent folder.

List Folders

Return one bounded page of Clio folders using documented filters.

List Groups

List Clio groups and IDs for matter assignments and user grouping.

List Matter Contacts

Return one bounded page of Clio matter-contact association records, including association ID and ETag, relationship label, is_client, matter reference, and contact details.

List Matter Protected Funds

Return one bounded page of protected funds for a Clio matter.

List Matter Related Contacts

Return one bounded page of Clio related-contact relationship records, including relationship ID, contact_id, and whether the contact is also the matter client.

List Matter Stages

List Clio matter stages and practice-area associations for selecting a matter stage.

List Notes

Return one bounded page of Clio matter or contact notes.

List Practice Areas

List Clio practice areas and IDs for matter and task-template selection.

List Task Template Lists

List Clio task template lists and IDs for assigning templates to matters.

List Users

List Clio users for attorney, staff, task-assignee, and activity-user references, defaulting to enabled users but allowing disabled users to be requested.

Preview Bill

Render one Clio bill as HTML, cap the response at 2 MB, and offload it as a file instead of returning active HTML inline.

Search Activities

Search and filter Clio activities, including multiple activity IDs, one page at a time.

Search Calendar Entries

Search Clio calendar entries by time window, text, calendar, matter, or ID, one page at a time.

Search Contacts

Search and filter Clio contacts, including multiple contact IDs, one page at a time.

Search Matters

Search and filter Clio matters, including multiple matter IDs, one page at a time.

Search Tasks

Search and filter Clio tasks, including multiple task IDs, one page at a time.

Start Document From Template

Start Clio's asynchronous create-document-from-template generation and return the automation ID, current state, and any documents already present.

Transition Bill State

Irreversibly transition a bill to paid, void, or deleted only after exact identity, ETag, expected current state, available transition, and explicit confirmation checks.

Update Activity

Update at least one field on an existing Clio time or expense activity, optionally using its ETag as a concurrency precondition; posted or billed activities may be immutable, and Activities write permission is required.

Update Bill

Update ordinary bill presentation, financial, tax, discount, or interest fields using the required current ETag.

Update Calendar

Update at least one of an existing Clio calendar's name, color, source, or visibility after reading its current ETag.

Update Calendar Entry

Update at least one field on a Clio calendar entry without sending calendar notifications.

Update Communication

Update a recorded Clio communication using its current ETag, including explicitly confirmed irreversible deletion of external properties.

Update Contact

Update at least one field on a Clio person or company, including adding or updating nested email and phone records.

Update Document Metadata

Update only Clio document metadata with an If-Match ETag.

Update Folder

Rename, move, recategorize, or restore a Clio folder, and add, change, or explicitly and irreversibly delete external properties, using its current ETag.

Update Matter

Update at least one field on an existing Clio matter, optionally using its ETag for concurrency safety.

Update Note

Update a Clio note using its current ETag.

Update Task

Update at least one field on an existing Clio task; reassignment selects one user or contact, replacing any multiple assignees, with assignee notifications disabled.

Void Bill

Irreversibly void an Unpaid bill after exact ID, number, ETag, state, and confirmation checks.

FAQ

Frequently asked questions

Start with Clio Manage (US).It takes 30 seconds.

Managed auth, hosted MCP servers, and every Clio Manage (US) tool your agent needs.Free to start.

Start building