Clio MCP by usefulapi is an MCP server published by io.usefulapi, hosted at clio.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 23 tools, including clio_who_am_i, clio_list_users, clio_list_matters, clio_get_matter, clio_list_contacts.
Read Clio matters, contacts, time, tasks, calendar and bills; add matters, time entries, notes.
4,253 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Fetch the Clio user this access token belongs to — name, email, subscription type, time zone and default_calendar_id (needed to create calendar entries). A cheap way to confirm the token and region are right. Clio: GET /users/who_am_i.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
{
"name": "clio_who_am_i",
"title": "Who am I",
"description": "Fetch the Clio user this access token belongs to — name, email, subscription type, time zone and default_calendar_id (needed to create calendar entries). A cheap way to confirm the token and region are right. Clio: GET /users/who_am_i.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
}
}
},
"annotations": {
"title": "Who am I",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List the firm's Clio users (attorneys and staff) — use their ids for responsible attorneys, time entries and task assignees. Clio: GET /users.json.
| Parameter | Type | Description |
|---|---|---|
| name | string | Only users with this name. |
| role | string | Only users with this role. |
| limit | integer | Records per page, 1-2000 (default 50). |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| enabled | boolean | Only enabled (true) or disabled (false) users. |
| page_token | string | next_page.page_token from the previous page. Omit for the first page. |
| subscription_type | string | Only attorneys or non-attorneys. |
{
"name": "clio_list_users",
"title": "List users",
"description": "List the firm's Clio users (attorneys and staff) — use their ids for responsible attorneys, time entries and task assignees. Clio: GET /users.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"name": {
"type": "string",
"description": "Only users with this name."
},
"role": {
"enum": [
"admin",
"accounts",
"billing",
"reports"
],
"type": "string",
"description": "Only users with this role."
},
"limit": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Records per page, 1-2000 (default 50)."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"enabled": {
"type": "boolean",
"description": "Only enabled (true) or disabled (false) users."
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"subscription_type": {
"enum": [
"attorney",
"nonattorney"
],
"type": "string",
"description": "Only attorneys or non-attorneys."
}
}
},
"annotations": {
"title": "List users",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Search and list matters (the firm's cases) with their client, practice area, responsible attorney and status. `query` wildcard-matches matter number or description and the client's name; custom_field_id + custom_field_value filter by one of the firm's custom fields (e.g. a court case number). Clio: GET /matters.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc), the only order that allows unlimited cursor paging. |
| query | string | Wildcard search on display number, number, description, or the client's name. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| status | string | open, closed or pending — or several comma-separated, e.g. open,pending. |
| billable | boolean | Only billable (true) or non-billable (false) matters. |
| client_id | integer | Only this client's (contact id) matters. |
Fetch a single matter by id, with its client, practice area, stage, attorneys and custom field values (field_name + value; a picklist value is an option id, see clio_list_custom_fields). Clio: GET /matters/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| matter_id * | integer | The matter's numeric Clio id. |
{
"name": "clio_get_matter",
"title": "Get one matter",
"description": "Fetch a single matter by id, with its client, practice area, stage, attorneys and custom field values (field_name + value; a picklist value is an option id, see clio_list_custom_fields). Clio: GET /matters/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"matter_id"
],
"properties": {
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The matter's numeric Clio id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one matter",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Search and list contacts — clients, prospective clients, companies, opposing parties and co-counsel. `query` wildcard-matches name, email, phone, address and more; custom_field_id + custom_field_value filter by one of the firm's custom fields. Clio: GET /contacts.json.
| Parameter | Type | Description |
|---|---|---|
| type | string | Only people or only companies. |
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search across name, title, email, phone, address, web site and custom fields. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| initial | string | Only contacts whose last name or company name starts with this letter (A-Z). |
| email_only | boolean | Only contacts that have an email address. |
| page_token | string |
Fetch a single contact by id with all email addresses, phone numbers, postal addresses, web sites and custom field values (field_name + value; a picklist value is an option id, see clio_list_custom_fields). Clio: GET /contacts/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| contact_id * | integer | The contact's numeric Clio id. |
{
"name": "clio_get_contact",
"title": "Get one contact",
"description": "Fetch a single contact by id with all email addresses, phone numbers, postal addresses, web sites and custom field values (field_name + value; a picklist value is an option id, see clio_list_custom_fields). Clio: GET /contacts/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The contact's numeric Clio id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one contact",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List activities — time entries, expense entries and fixed fees — with hours, rate, total and billing status. Filter by matter, user, type, status or date range. `quantity` is in seconds; `quantity_in_hours` is hours. Clio: GET /activities.json.
| Parameter | Type | Description |
|---|---|---|
| type | string | Only this kind of activity. |
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search on the activity's note. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| status | string | Only activities in this billing status. |
| user_id | integer | Only this user's activities. |
| end_date | string | Only activities dated on or before this day (ISO-8601 date or timestamp). |
List tasks with status, priority, due date, matter and assignee. Filter by matter, assignee, status, priority or a due-date range — e.g. what is due this week. Clio: GET /tasks.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search on the task's name or description. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| status | string | Only tasks in this status (without advanced tasks, only pending or complete). |
| complete | boolean | Only complete (true) or incomplete (false) tasks. |
| priority | string | Only tasks with this priority. |
| due_at_to | string | End of a due-date range (ISO-8601 date, YYYY-MM-DD). |
List calendar entries (hearings, meetings, deadlines) in a time window, optionally for one matter or calendar. Set expanded=true to get each occurrence of recurring events. Clio: GET /calendar_entries.json.
| Parameter | Type | Description |
|---|---|---|
| to | string | Only entries starting on or before this ISO-8601 timestamp. |
| from | string | Only entries ending on or after this ISO-8601 timestamp. |
| limit | integer | Records per page, 1-200 (default 50). |
| query | string | Search text. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| expanded | boolean | Return one record per occurrence of recurring events. |
| matter_id | integer | Only this matter's entries. |
| is_all_day | boolean | Only all-day (true) or timed (false) entries. |
List bills (invoices) with state, totals, amount due and dates. Filter by client, matter, state, overdue, or issue/due date. Clio: GET /bills.json.
| Parameter | Type | Description |
|---|---|---|
| type | string | Only revenue or trust bills. |
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| state | string | Only bills in this state. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| client_id | integer | Only this client's bills. |
| due_after | string | Only bills due after this day (ISO-8601 date, YYYY-MM-DD). |
| matter_id | integer | Only this matter's bills. |
| due_before | string |
Fetch a single bill by id with its state, totals, balance, client and matters. Clio: GET /bills/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| bill_id * | integer | The bill's numeric Clio id. |
{
"name": "clio_get_bill",
"title": "Get one bill",
"description": "Fetch a single bill by id with its state, totals, balance, client and matters. Clio: GET /bills/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"bill_id"
],
"properties": {
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"bill_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The bill's numeric Clio id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Get one bill",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}List documents (metadata only: name, file name, type, size, category, dates) for a matter, a contact or a folder, or search them by name. Clio: GET /documents.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search on the document name. |
| scope | string | With parent_id: direct children only (default) or everything beneath the folder. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| matter_id | integer | Only this matter's documents. |
| parent_id | integer | Only documents in this folder. |
| contact_id | integer | Only this contact's documents. |
| page_token |
List notes on a matter or a contact, with subject, body, date and author. Clio requires type; narrow to one matter or contact with matter_id or contact_id. Clio: GET /notes.json.
| Parameter | Type | Description |
|---|---|---|
| type * | string | Matter notes or contact notes. |
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search across subject and detail. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| matter_id | integer | For type Matter: the matter's id. |
| contact_id | integer | For type Contact: the contact's id. |
| page_token | string | next_page.page_token from the previous page. Omit for the first page. |
List the firm's custom fields for matters or contacts — name, type, whether required, and the options of picklist fields (option id + text). Use the ids to filter clio_list_matters / clio_list_contacts and to read the values that clio_get_matter / clio_get_contact return. Clio: GET /custom_fields.json.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Records per page, 1-200 (default 50). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search on the field name. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| deleted | boolean | Only fields deleted for future use (true) or active ones (false). |
| field_type | string | Only fields of this type. |
| page_token | string | next_page.page_token from the previous page. Omit for the first page. |
| parent_type | string |
List logged communications — phone calls and emails recorded on matters — with subject, body, date, senders and receivers. Filter by matter, contact, user, type or date range, or search subject and body. Clio: GET /communications.json.
| Parameter | Type | Description |
|---|---|---|
| type | string | Only phone calls or only emails. |
| limit | integer | Records per page, 1-200 (default 20: email bodies can be long). |
| order | string | Sort order. Default id(asc). |
| query | string | Wildcard search on subject and body. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| offset | integer | next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records). |
| user_id | integer | Only communications of this user. |
| matter_id | integer | Only this matter's communications. |
| contact_id | integer | Only communications with this contact. |
WRITE: Create a contact — a person (give first_name and/or last_name) or a company (give name) — optionally with an email address and phone number. Clio: POST /contacts.json.
| Parameter | Type | Description |
|---|---|---|
| name | string | Company: the company name. (For a person, prefer first_name/last_name.) |
| type * | string | Person or Company. |
| string | An email address to add. | |
| phone | string | A phone number to add. |
| title | string | Professional title, e.g. General Counsel. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| prefix | string | Personal title, e.g. Dr. |
| last_name | string | Person: last name. |
| email_type | string | Label for the email address (default Work). |
| first_name | string | Person: first name. |
WRITE: Open a new matter for an existing client contact. Requires the client's contact id and a description. Clio: POST /matters.json.
| Parameter | Type | Description |
|---|---|---|
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| status | string | Initial status (Clio defaults to open). |
| billable | boolean | Whether the matter is billable. |
| location | string | Location of the matter. |
| client_id * | integer | The client contact's numeric Clio id. |
| open_date | string | Open date (ISO-8601 date, YYYY-MM-DD). |
| description * | string | What the matter is, e.g. 'Smith v. Jones — lease dispute'. |
| client_reference | string | The client's own reference for this matter. |
| practice_area_id | integer | Practice area id. |
| originating_attorney_id |
WRITE: Record billable (or non-billable) time on a matter. Give hours as a decimal (1.5 = 90 minutes); it is sent to Clio as seconds. If price (hourly rate) is omitted Clio applies the firm's rate hierarchy; if user_id is omitted it records for the token's user. Clio: POST /activities.json with type TimeEntry.
| Parameter | Type | Description |
|---|---|---|
| date * | string | The day the work was done (ISO-8601 date, YYYY-MM-DD). |
| note | string | What the time was for — this appears on the bill. |
| hours * | number | Time spent, in hours (decimal). |
| price | number | Hourly rate override. Omit to use Clio's rate hierarchy. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| user_id | integer | The user who did the work (default: the token's user). |
| matter_id * | integer | The matter's numeric Clio id. |
| non_billable | boolean | Keep this entry off the bill. |
| activity_description_id |
WRITE: Create a task and assign it to a firm user or a contact, optionally on a matter with a due date and priority. Clio: POST /tasks.json.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Short name of the task. |
| due_at | string | Due date (ISO-8601 date, YYYY-MM-DD). |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| status | string | Initial status (without advanced tasks, only pending or complete). |
| priority | string | Priority. |
| matter_id | integer | The matter the task belongs to. |
| permission | string | Visibility (Clio default public). |
| assignee_id * | integer | The user or contact to assign the task to. |
| description * | string | Longer description of the task. |
| assignee_type |
WRITE: Update a task — mark it complete, change its status, due date, priority, name or description, or reassign it. Only the fields given are changed. Clio: PATCH /tasks/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| name | string | New name. |
| due_at | string | New due date (ISO-8601 date, YYYY-MM-DD). |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| status | string | New status, e.g. complete. |
| task_id * | integer | The task's numeric Clio id. |
| priority | string | New priority. |
| assignee_id | integer | Reassign to this user or contact. Requires assignee_type. |
| description | string | New description. |
| assignee_type | string | Whether assignee_id is a User or a Contact. |
WRITE: Add a note to a matter (type Matter + matter_id) or to a contact (type Contact + contact_id). Clio: POST /notes.json.
| Parameter | Type | Description |
|---|---|---|
| date | string | Date of the note (ISO-8601 date, YYYY-MM-DD). |
| type * | string | Attach to a matter or a contact. |
| detail * | string | Note body (plain text). |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| subject | string | Note subject. |
| matter_id | integer | For type Matter: the matter's id. |
| contact_id | integer | For type Contact: the contact's id. |
{
"name": "clio_create_note",
"title": "Create a note",
"description": "WRITE: Add a note to a matter (type Matter + matter_id) or to a contact (type Contact + contact_id). Clio: POST /notes.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"detail"
],
"properties": {
"date": {
"type": "string",
"description": "Date of the note (ISO-8601 date, YYYY-MM-DD)."
},
"type": {
"enum": [
"Matter",
"Contact"
],
"type": "string",
"description": "Attach to a matter or a contact."
},
"detail": {
"type": "string",
"description": "Note body (plain text)."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"subject": {
"type": "string",
"description": "Note subject."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "For type Matter: the matter's id.",
"exclusiveMinimum": 0
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "For type Contact: the contact's id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a note",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}WRITE: Record a phone call or an email on Clio's communication log, optionally on a matter, with who it was from and to. This only records it: Clio sends nothing. To bill the time, also use clio_create_time_entry. Clio: POST /communications.json.
| Parameter | Type | Description |
|---|---|---|
| body * | string | What was said or written (plain text). |
| type * | string | A phone call or an email. |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| senders | array | Who it came from: firm users and/or contacts. |
| subject * | string | Subject line, e.g. 'Call with client about settlement'. |
| matter_id | integer | The matter it belongs to. |
| receivers | array | Who it went to: firm users and/or contacts. |
| received_at * | string | When it took place (ISO-8601 timestamp, e.g. 2026-10-02T09:30:00-07:00). |
WRITE: Put an event on a Clio calendar — a hearing, meeting or deadline — optionally linked to a matter. calendar_id is the calendar to put it on (the token user's own is default_calendar_id from clio_who_am_i). Clio: POST /calendar_entries.json.
| Parameter | Type | Description |
|---|---|---|
| end_at * | string | End (ISO-8601 timestamp). |
| fields | string | Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default. |
| all_day | boolean | An all-day event. |
| summary * | string | Short title of the event. |
| location | string | Where it takes place. |
| start_at * | string | Start (ISO-8601 timestamp, e.g. 2026-10-02T09:30:00-07:00). |
| matter_id | integer | The matter this event belongs to. |
| calendar_id * | integer | The calendar's numeric Clio id. |
| description | string |
Tools for Clio, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which of my matters are open, and who is the responsible attorney on each?"; "What tasks are due this week across the firm?"; "Show unbilled time for the Smith matter and which bills are overdue.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Clio data. Free plan: 50 tool calls per month. Run clio_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run clio_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run clio_upgrade without a plan: it returns both plans, each with a payment link for the user to open. clio_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| page_token |
| string |
| next_page.page_token from the previous page. Omit for the first page. |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
| custom_field_id | integer | Only records whose custom field with this id (from clio_list_custom_fields) matches custom_field_value. |
| practice_area_id | integer | Only matters in this practice area. |
| custom_field_value | string | The value to match. Checkbox: true or false; picklist: the option id; contact or matter field: the record id; date: YYYY-MM-DD. Text, checkbox, picklist, contact and matter fields always match exactly. |
| custom_field_operator | string | Required for currency, date, time and numeric fields (= for an exact match); leave it out for every other field type. |
| originating_attorney_id | integer | Only matters with this originating attorney (user id). |
| responsible_attorney_id | integer | Only matters with this responsible attorney (user id). |
{
"name": "clio_list_matters",
"title": "List matters",
"description": "Search and list matters (the firm's cases) with their client, practice area, responsible attorney and status. `query` wildcard-matches matter number or description and the client's name; custom_field_id + custom_field_value filter by one of the firm's custom fields (e.g. a court case number). Clio: GET /matters.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"display_number(asc)",
"display_number(desc)",
"open_date(asc)",
"open_date(desc)",
"close_date(asc)",
"close_date(desc)",
"updated_at(asc)",
"updated_at(desc)",
"created_at(asc)",
"created_at(desc)",
"client.name(asc)",
"client.name(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc), the only order that allows unlimited cursor paging."
},
"query": {
"type": "string",
"description": "Wildcard search on display number, number, description, or the client's name."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"status": {
"type": "string",
"description": "open, closed or pending — or several comma-separated, e.g. open,pending."
},
"billable": {
"type": "boolean",
"description": "Only billable (true) or non-billable (false) matters."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this client's (contact id) matters.",
"exclusiveMinimum": 0
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
},
"custom_field_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only records whose custom field with this id (from clio_list_custom_fields) matches custom_field_value.",
"exclusiveMinimum": 0
},
"practice_area_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only matters in this practice area.",
"exclusiveMinimum": 0
},
"custom_field_value": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The value to match. Checkbox: true or false; picklist: the option id; contact or matter field: the record id; date: YYYY-MM-DD. Text, checkbox, picklist, contact and matter fields always match exactly."
},
"custom_field_operator": {
"enum": [
"=",
"<",
">",
"<=",
">="
],
"type": "string",
"description": "Required for currency, date, time and numeric fields (= for an exact match); leave it out for every other field type."
},
"originating_attorney_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only matters with this originating attorney (user id).",
"exclusiveMinimum": 0
},
"responsible_attorney_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only matters with this responsible attorney (user id).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List matters",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| next_page.page_token from the previous page. Omit for the first page. |
| client_only | boolean | Only contacts who are clients. |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
| custom_field_id | integer | Only records whose custom field with this id (from clio_list_custom_fields) matches custom_field_value. |
| custom_field_value | string | The value to match. Checkbox: true or false; picklist: the option id; contact or matter field: the record id; date: YYYY-MM-DD. Text, checkbox, picklist, contact and matter fields always match exactly. |
| custom_field_operator | string | Required for currency, date, time and numeric fields (= for an exact match); leave it out for every other field type. |
{
"name": "clio_list_contacts",
"title": "List contacts",
"description": "Search and list contacts — clients, prospective clients, companies, opposing parties and co-counsel. `query` wildcard-matches name, email, phone, address and more; custom_field_id + custom_field_value filter by one of the firm's custom fields. Clio: GET /contacts.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"Person",
"Company"
],
"type": "string",
"description": "Only people or only companies."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"name(asc)",
"name(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search across name, title, email, phone, address, web site and custom fields."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"initial": {
"type": "string",
"maxLength": 1,
"minLength": 1,
"description": "Only contacts whose last name or company name starts with this letter (A-Z)."
},
"email_only": {
"type": "boolean",
"description": "Only contacts that have an email address."
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"client_only": {
"type": "boolean",
"description": "Only contacts who are clients."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
},
"custom_field_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only records whose custom field with this id (from clio_list_custom_fields) matches custom_field_value.",
"exclusiveMinimum": 0
},
"custom_field_value": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The value to match. Checkbox: true or false; picklist: the option id; contact or matter field: the record id; date: YYYY-MM-DD. Text, checkbox, picklist, contact and matter fields always match exactly."
},
"custom_field_operator": {
"enum": [
"=",
"<",
">",
"<=",
">="
],
"type": "string",
"description": "Required for currency, date, time and numeric fields (= for an exact match); leave it out for every other field type."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| matter_id | integer | Only this matter's activities. |
| page_token | string | next_page.page_token from the previous page. Omit for the first page. |
| start_date | string | Only activities dated on or after this day (ISO-8601 date or timestamp). |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
{
"name": "clio_list_activities",
"title": "List activities (time and expenses)",
"description": "List activities — time entries, expense entries and fixed fees — with hours, rate, total and billing status. Filter by matter, user, type, status or date range. `quantity` is in seconds; `quantity_in_hours` is hours. Clio: GET /activities.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"TimeEntry",
"ExpenseEntry",
"HardCostEntry",
"SoftCostEntry",
"FixedFee"
],
"type": "string",
"description": "Only this kind of activity."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"date(asc)",
"date(desc)",
"total(asc)",
"total(desc)",
"updated_at(asc)",
"updated_at(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search on the activity's note."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"status": {
"enum": [
"billed",
"draft",
"unbilled",
"non_billable",
"billable",
"written_off"
],
"type": "string",
"description": "Only activities in this billing status."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this user's activities.",
"exclusiveMinimum": 0
},
"end_date": {
"type": "string",
"description": "Only activities dated on or before this day (ISO-8601 date or timestamp)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this matter's activities.",
"exclusiveMinimum": 0
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"start_date": {
"type": "string",
"description": "Only activities dated on or after this day (ISO-8601 date or timestamp)."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List activities (time and expenses)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| matter_id |
| integer |
| Only this matter's tasks. |
| page_token | string | next_page.page_token from the previous page. Omit for the first page. |
| assignee_id | integer | Only tasks assigned to this user or contact id. Requires assignee_type. |
| due_at_from | string | Start of a due-date range (ISO-8601 date, YYYY-MM-DD). |
| assignee_type | string | Whether assignee_id is a user or a contact. |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
| statute_of_limitations | boolean | Only statute-of-limitations tasks (true) or others (false). |
{
"name": "clio_list_tasks",
"title": "List tasks",
"description": "List tasks with status, priority, due date, matter and assignee. Filter by matter, assignee, status, priority or a due-date range — e.g. what is due this week. Clio: GET /tasks.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"due_at(asc)",
"due_at(desc)",
"priority(asc)",
"priority(desc)",
"name(asc)",
"name(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search on the task's name or description."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"status": {
"enum": [
"pending",
"in_progress",
"in_review",
"complete",
"draft"
],
"type": "string",
"description": "Only tasks in this status (without advanced tasks, only pending or complete)."
},
"complete": {
"type": "boolean",
"description": "Only complete (true) or incomplete (false) tasks."
},
"priority": {
"enum": [
"high",
"normal",
"low"
],
"type": "string",
"description": "Only tasks with this priority."
},
"due_at_to": {
"type": "string",
"description": "End of a due-date range (ISO-8601 date, YYYY-MM-DD)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this matter's tasks.",
"exclusiveMinimum": 0
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only tasks assigned to this user or contact id. Requires assignee_type.",
"exclusiveMinimum": 0
},
"due_at_from": {
"type": "string",
"description": "Start of a due-date range (ISO-8601 date, YYYY-MM-DD)."
},
"assignee_type": {
"enum": [
"user",
"contact"
],
"type": "string",
"description": "Whether assignee_id is a user or a contact."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
},
"statute_of_limitations": {
"type": "boolean",
"description": "Only statute-of-limitations tasks (true) or others (false)."
}
}
},
"annotations": {
"title": "List tasks",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| page_token |
| string |
| next_page.page_token from the previous page. Omit for the first page. |
| calendar_id | integer | Only entries on this calendar. |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
{
"name": "clio_list_calendar_entries",
"title": "List calendar entries",
"description": "List calendar entries (hearings, meetings, deadlines) in a time window, optionally for one matter or calendar. Set expanded=true to get each occurrence of recurring events. Clio: GET /calendar_entries.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "string",
"description": "Only entries starting on or before this ISO-8601 timestamp."
},
"from": {
"type": "string",
"description": "Only entries ending on or after this ISO-8601 timestamp."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"query": {
"type": "string",
"description": "Search text."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"expanded": {
"type": "boolean",
"description": "Return one record per occurrence of recurring events."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this matter's entries.",
"exclusiveMinimum": 0
},
"is_all_day": {
"type": "boolean",
"description": "Only all-day (true) or timed (false) entries."
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"calendar_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only entries on this calendar.",
"exclusiveMinimum": 0
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List calendar entries",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| Only bills due before this day (ISO-8601 date, YYYY-MM-DD). |
| page_token | string | next_page.page_token from the previous page. Omit for the first page. |
| issued_after | string | Only bills issued after this day (ISO-8601 date, YYYY-MM-DD). |
| overdue_only | boolean | Only overdue bills. |
| issued_before | string | Only bills issued before this day (ISO-8601 date, YYYY-MM-DD). |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
{
"name": "clio_list_bills",
"title": "List bills",
"description": "List bills (invoices) with state, totals, amount due and dates. Filter by client, matter, state, overdue, or issue/due date. Clio: GET /bills.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"revenue",
"trust"
],
"type": "string",
"description": "Only revenue or trust bills."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"issued_at(asc)",
"issued_at(desc)",
"due_at(asc)",
"due_at(desc)",
"balance(asc)",
"balance(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"state": {
"enum": [
"draft",
"awaiting_approval",
"awaiting_payment",
"paid",
"void",
"deleted"
],
"type": "string",
"description": "Only bills in this state."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this client's bills.",
"exclusiveMinimum": 0
},
"due_after": {
"type": "string",
"description": "Only bills due after this day (ISO-8601 date, YYYY-MM-DD)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this matter's bills.",
"exclusiveMinimum": 0
},
"due_before": {
"type": "string",
"description": "Only bills due before this day (ISO-8601 date, YYYY-MM-DD)."
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"issued_after": {
"type": "string",
"description": "Only bills issued after this day (ISO-8601 date, YYYY-MM-DD)."
},
"overdue_only": {
"type": "boolean",
"description": "Only overdue bills."
},
"issued_before": {
"type": "string",
"description": "Only bills issued before this day (ISO-8601 date, YYYY-MM-DD)."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List bills",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| string |
| next_page.page_token from the previous page. Omit for the first page. |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
| document_category_id | integer | Only documents in this category. |
{
"name": "clio_list_documents",
"title": "List documents",
"description": "List documents (metadata only: name, file name, type, size, category, dates) for a matter, a contact or a folder, or search them by name. Clio: GET /documents.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"name(asc)",
"name(desc)",
"updated_at(asc)",
"updated_at(desc)",
"created_at(asc)",
"created_at(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search on the document name."
},
"scope": {
"enum": [
"children",
"descendants"
],
"type": "string",
"description": "With parent_id: direct children only (default) or everything beneath the folder."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this matter's documents.",
"exclusiveMinimum": 0
},
"parent_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only documents in this folder.",
"exclusiveMinimum": 0
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this contact's documents.",
"exclusiveMinimum": 0
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
},
"document_category_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only documents in this category.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "List documents",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| updated_since |
| string |
| Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
{
"name": "clio_list_notes",
"title": "List notes",
"description": "List notes on a matter or a contact, with subject, body, date and author. Clio requires type; narrow to one matter or contact with matter_id or contact_id. Clio: GET /notes.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type"
],
"properties": {
"type": {
"enum": [
"Matter",
"Contact"
],
"type": "string",
"description": "Matter notes or contact notes."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"date(asc)",
"date(desc)",
"updated_at(asc)",
"updated_at(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search across subject and detail."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "For type Matter: the matter's id.",
"exclusiveMinimum": 0
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "For type Contact: the contact's id.",
"exclusiveMinimum": 0
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
}
}
},
"annotations": {
"title": "List notes",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| Only matter fields or only contact fields. |
| visible_and_required | boolean | Only fields that are visible and required. |
{
"name": "clio_list_custom_fields",
"title": "List custom fields",
"description": "List the firm's custom fields for matters or contacts — name, type, whether required, and the options of picklist fields (option id + text). Use the ids to filter clio_list_matters / clio_list_contacts and to read the values that clio_get_matter / clio_get_contact return. Clio: GET /custom_fields.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 50)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"name(asc)",
"name(desc)",
"display_order(asc)",
"display_order(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search on the field name."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"deleted": {
"type": "boolean",
"description": "Only fields deleted for future use (true) or active ones (false)."
},
"field_type": {
"enum": [
"checkbox",
"contact",
"currency",
"date",
"time",
"email",
"matter",
"numeric",
"picklist",
"text_area",
"text_line",
"url"
],
"type": "string",
"description": "Only fields of this type."
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"parent_type": {
"enum": [
"matter",
"contact"
],
"type": "string",
"description": "Only matter fields or only contact fields."
},
"visible_and_required": {
"type": "boolean",
"description": "Only fields that are visible and required."
}
}
},
"annotations": {
"title": "List custom fields",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| page_token |
| string |
| next_page.page_token from the previous page. Omit for the first page. |
| updated_since | string | Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z. |
| received_since | string | Only communications on or after this day (ISO-8601 date, YYYY-MM-DD). |
| received_before | string | Only communications on or before this day (ISO-8601 date, YYYY-MM-DD). |
| having_time_entries | boolean | Only communications with (true) or without (false) time entries. |
{
"name": "clio_list_communications",
"title": "List communications",
"description": "List logged communications — phone calls and emails recorded on matters — with subject, body, date, senders and receivers. Filter by matter, contact, user, type or date range, or search subject and body. Clio: GET /communications.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"PhoneCommunication",
"EmailCommunication"
],
"type": "string",
"description": "Only phone calls or only emails."
},
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1,
"description": "Records per page, 1-200 (default 20: email bodies can be long)."
},
"order": {
"enum": [
"id(asc)",
"id(desc)",
"date(asc)",
"date(desc)",
"received_at(asc)",
"received_at(desc)"
],
"type": "string",
"description": "Sort order. Default id(asc)."
},
"query": {
"type": "string",
"description": "Wildcard search on subject and body."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"offset": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "next_page.offset from the previous page (used when a custom order is set; capped at 10,000 records)."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only communications of this user.",
"exclusiveMinimum": 0
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only this matter's communications.",
"exclusiveMinimum": 0
},
"contact_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Only communications with this contact.",
"exclusiveMinimum": 0
},
"page_token": {
"type": "string",
"description": "next_page.page_token from the previous page. Omit for the first page."
},
"updated_since": {
"type": "string",
"description": "Only records updated after this ISO-8601 timestamp, e.g. 2026-09-01T00:00:00Z."
},
"received_since": {
"type": "string",
"description": "Only communications on or after this day (ISO-8601 date, YYYY-MM-DD)."
},
"received_before": {
"type": "string",
"description": "Only communications on or before this day (ISO-8601 date, YYYY-MM-DD)."
},
"having_time_entries": {
"type": "boolean",
"description": "Only communications with (true) or without (false) time entries."
}
}
},
"annotations": {
"title": "List communications",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| phone_type | string | Label for the phone number (default Work). |
| middle_name | string | Person: middle name. |
{
"name": "clio_create_contact",
"title": "Create a contact",
"description": "WRITE: Create a contact — a person (give first_name and/or last_name) or a company (give name) — optionally with an email address and phone number. Clio: POST /contacts.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type"
],
"properties": {
"name": {
"type": "string",
"description": "Company: the company name. (For a person, prefer first_name/last_name.)"
},
"type": {
"enum": [
"Person",
"Company"
],
"type": "string",
"description": "Person or Company."
},
"email": {
"type": "string",
"description": "An email address to add."
},
"phone": {
"type": "string",
"description": "A phone number to add."
},
"title": {
"type": "string",
"description": "Professional title, e.g. General Counsel."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"prefix": {
"type": "string",
"description": "Personal title, e.g. Dr."
},
"last_name": {
"type": "string",
"description": "Person: last name."
},
"email_type": {
"enum": [
"Work",
"Home",
"Other"
],
"type": "string",
"description": "Label for the email address (default Work)."
},
"first_name": {
"type": "string",
"description": "Person: first name."
},
"phone_type": {
"enum": [
"Work",
"Home",
"Mobile",
"Fax",
"Pager",
"Skype",
"Other"
],
"type": "string",
"description": "Label for the phone number (default Work)."
},
"middle_name": {
"type": "string",
"description": "Person: middle name."
}
}
},
"annotations": {
"title": "Create a contact",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| integer |
| Originating attorney (user id). |
| responsible_attorney_id | integer | Responsible attorney (user id). |
{
"name": "clio_create_matter",
"title": "Create a matter",
"description": "WRITE: Open a new matter for an existing client contact. Requires the client's contact id and a description. Clio: POST /matters.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"client_id",
"description"
],
"properties": {
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"status": {
"enum": [
"open",
"pending",
"closed"
],
"type": "string",
"description": "Initial status (Clio defaults to open)."
},
"billable": {
"type": "boolean",
"description": "Whether the matter is billable."
},
"location": {
"type": "string",
"description": "Location of the matter."
},
"client_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The client contact's numeric Clio id.",
"exclusiveMinimum": 0
},
"open_date": {
"type": "string",
"description": "Open date (ISO-8601 date, YYYY-MM-DD)."
},
"description": {
"type": "string",
"description": "What the matter is, e.g. 'Smith v. Jones — lease dispute'."
},
"client_reference": {
"type": "string",
"description": "The client's own reference for this matter."
},
"practice_area_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Practice area id.",
"exclusiveMinimum": 0
},
"originating_attorney_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Originating attorney (user id).",
"exclusiveMinimum": 0
},
"responsible_attorney_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Responsible attorney (user id).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create a matter",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| integer |
| An activity description (billing code) id. |
{
"name": "clio_create_time_entry",
"title": "Record a time entry",
"description": "WRITE: Record billable (or non-billable) time on a matter. Give hours as a decimal (1.5 = 90 minutes); it is sent to Clio as seconds. If price (hourly rate) is omitted Clio applies the firm's rate hierarchy; if user_id is omitted it records for the token's user. Clio: POST /activities.json with type TimeEntry.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"matter_id",
"date",
"hours"
],
"properties": {
"date": {
"type": "string",
"description": "The day the work was done (ISO-8601 date, YYYY-MM-DD)."
},
"note": {
"type": "string",
"description": "What the time was for — this appears on the bill."
},
"hours": {
"type": "number",
"maximum": 24,
"description": "Time spent, in hours (decimal).",
"exclusiveMinimum": 0
},
"price": {
"type": "number",
"minimum": 0,
"description": "Hourly rate override. Omit to use Clio's rate hierarchy."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"user_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The user who did the work (default: the token's user).",
"exclusiveMinimum": 0
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The matter's numeric Clio id.",
"exclusiveMinimum": 0
},
"non_billable": {
"type": "boolean",
"description": "Keep this entry off the bill."
},
"activity_description_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "An activity description (billing code) id.",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Record a time entry",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| string |
| Whether assignee_id is a User or a Contact. |
| notify_assignee | boolean | Notify the assignee on creation. |
| statute_of_limitations | boolean | Mark as a statute-of-limitations task. |
{
"name": "clio_create_task",
"title": "Create a task",
"description": "WRITE: Create a task and assign it to a firm user or a contact, optionally on a matter with a due date and priority. Clio: POST /tasks.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"description",
"assignee_id",
"assignee_type"
],
"properties": {
"name": {
"type": "string",
"description": "Short name of the task."
},
"due_at": {
"type": "string",
"description": "Due date (ISO-8601 date, YYYY-MM-DD)."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"status": {
"enum": [
"pending",
"in_progress",
"in_review",
"complete",
"draft"
],
"type": "string",
"description": "Initial status (without advanced tasks, only pending or complete)."
},
"priority": {
"enum": [
"High",
"Normal",
"Low"
],
"type": "string",
"description": "Priority."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The matter the task belongs to.",
"exclusiveMinimum": 0
},
"permission": {
"enum": [
"public",
"private"
],
"type": "string",
"description": "Visibility (Clio default public)."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The user or contact to assign the task to.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "Longer description of the task."
},
"assignee_type": {
"enum": [
"User",
"Contact"
],
"type": "string",
"description": "Whether assignee_id is a User or a Contact."
},
"notify_assignee": {
"type": "boolean",
"description": "Notify the assignee on creation."
},
"statute_of_limitations": {
"type": "boolean",
"description": "Mark as a statute-of-limitations task."
}
}
},
"annotations": {
"title": "Create a task",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}{
"name": "clio_update_task",
"title": "Update a task",
"description": "WRITE: Update a task — mark it complete, change its status, due date, priority, name or description, or reassign it. Only the fields given are changed. Clio: PATCH /tasks/{id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"task_id"
],
"properties": {
"name": {
"type": "string",
"description": "New name."
},
"due_at": {
"type": "string",
"description": "New due date (ISO-8601 date, YYYY-MM-DD)."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"status": {
"enum": [
"pending",
"in_progress",
"in_review",
"complete",
"draft"
],
"type": "string",
"description": "New status, e.g. complete."
},
"task_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The task's numeric Clio id.",
"exclusiveMinimum": 0
},
"priority": {
"enum": [
"High",
"Normal",
"Low"
],
"type": "string",
"description": "New priority."
},
"assignee_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Reassign to this user or contact. Requires assignee_type.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "New description."
},
"assignee_type": {
"enum": [
"User",
"Contact"
],
"type": "string",
"description": "Whether assignee_id is a User or a Contact."
}
}
},
"annotations": {
"title": "Update a task",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}{
"name": "clio_log_communication",
"title": "Log a phone call or email",
"description": "WRITE: Record a phone call or an email on Clio's communication log, optionally on a matter, with who it was from and to. This only records it: Clio sends nothing. To bill the time, also use clio_create_time_entry. Clio: POST /communications.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"type",
"subject",
"body",
"received_at"
],
"properties": {
"body": {
"type": "string",
"minLength": 1,
"description": "What was said or written (plain text)."
},
"type": {
"enum": [
"PhoneCommunication",
"EmailCommunication"
],
"type": "string",
"description": "A phone call or an email."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"senders": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "User or contact id.",
"exclusiveMinimum": 0
},
"type": {
"enum": [
"User",
"Contact"
],
"type": "string"
}
}
},
"maxItems": 20,
"description": "Who it came from: firm users and/or contacts."
},
"subject": {
"type": "string",
"minLength": 1,
"description": "Subject line, e.g. 'Call with client about settlement'."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The matter it belongs to.",
"exclusiveMinimum": 0
},
"receivers": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"type"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "User or contact id.",
"exclusiveMinimum": 0
},
"type": {
"enum": [
"User",
"Contact"
],
"type": "string"
}
}
},
"maxItems": 20,
"description": "Who it went to: firm users and/or contacts."
},
"received_at": {
"type": "string",
"description": "When it took place (ISO-8601 timestamp, e.g. 2026-10-02T09:30:00-07:00)."
}
}
},
"annotations": {
"title": "Log a phone call or email",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}| Longer description. |
| send_email_notification | boolean | Email the attendees. |
{
"name": "clio_create_calendar_entry",
"title": "Create a calendar entry",
"description": "WRITE: Put an event on a Clio calendar — a hearing, meeting or deadline — optionally linked to a matter. calendar_id is the calendar to put it on (the token user's own is default_calendar_id from clio_who_am_i). Clio: POST /calendar_entries.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"calendar_id",
"summary",
"start_at",
"end_at"
],
"properties": {
"end_at": {
"type": "string",
"description": "End (ISO-8601 timestamp)."
},
"fields": {
"type": "string",
"maxLength": 1000,
"description": "Override the returned fields: a comma-separated list, nested resources in braces one level deep, e.g. id,name,matter{id,display_number}. Omit for a sensible default."
},
"all_day": {
"type": "boolean",
"description": "An all-day event."
},
"summary": {
"type": "string",
"description": "Short title of the event."
},
"location": {
"type": "string",
"description": "Where it takes place."
},
"start_at": {
"type": "string",
"description": "Start (ISO-8601 timestamp, e.g. 2026-10-02T09:30:00-07:00)."
},
"matter_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The matter this event belongs to.",
"exclusiveMinimum": 0
},
"calendar_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "The calendar's numeric Clio id.",
"exclusiveMinimum": 0
},
"description": {
"type": "string",
"description": "Longer description."
},
"send_email_notification": {
"type": "boolean",
"description": "Email the attendees."
}
}
},
"annotations": {
"title": "Create a calendar entry",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": true
}
}