Clio MCP server
Connect Claude to Clio: 34 tools for matters, custom fields, notes, documents, folders, billing.
24 stars230 downloads/wk
Reviews
Write oneNobody has reviewed Clio yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Clio tools (34, 10 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
auth_statusCheck whether the connector is authenticated with Clio and when the token expires
authenticateTrigger the Clio OAuth login flow
complete_taskMark a Clio task as complete
create_activitywrite actionCreate a Clio activity — TimeEntry, ExpenseEntry, HardCostEntry, or SoftCostEntry. For time entries on a matter, prefer log_time_entry.
create_calendar_entrywrite actionCreate a calendar entry (hearing, deadline, meeting) in Clio
create_folderwrite actionCreate a folder in Clio under a matter's document root or under an existing folder. Set if_not_exists for bulk work: the check then happens inside this call, so a repeated run cannot create duplicates.
create_matterwrite actionCreate a new matter in the connected Clio account. Requires numeric IDs: look up client_id via search_contacts, attorney IDs via list_users or get_user.
create_notewrite actionCreate a note on a matter in Clio
create_taskwrite actionCreate a task on a matter in Clio
export_audit_logExport audit log entries for bar review and ABA Opinion 512 compliance. Supports filtering by date range and matter. Results are paginated (default 500 per page).
folder_existsCheck whether a folder with the given exact name already exists under a matter's document root or under a parent folder. Fully paginates and never relies on parent-type filtering, so it won't false-negative on matters whose document root is itself a Folder node.
get_billing_summaryGet a billing summary for a matter — total billed, outstanding balance, and last invoice date
get_contactGet full detail for a single contact by ID
get_documentGet metadata and download URL for a single Clio document
get_matterGet full detail for a single matter by ID
get_userGet details for a single Clio user by their user ID
list_calendar_entriesList calendar entries in Clio for a given date range
list_calendarsList calendars available in Clio — use the returned id as calendar_owner_id when creating entries
list_custom_fieldsList the custom field definitions configured on this Clio account, with their types and (for picklists) their allowed options. Call this before reading or writing custom fields so you know what exists, what type each field is, and which option IDs a picklist accepts.
list_documentsList documents in Clio, filtered by matter or folder
list_foldersList folders in Clio, filtered by matter or parent folder
list_matter_relationshipsList the contacts attached to a matter and the role each one plays (co-counsel, expert, fact witness, opposing counsel, and any other relationship types the firm has configured). The matter's own client is a separate field on the matter and is not returned here.
list_mattersList matters from the connected Clio account
list_notesList notes on a matter or contact in Clio. Notes carry the narrative record (intake interviews, call summaries, case history), so this is usually where the detail behind a matter lives. Provide exactly one of matter_id or contact_id.
list_tasksList tasks from Clio with optional filters
list_time_entriesList time entries (billable hours) from Clio
list_usersList Clio firm users (attorneys and staff) with their IDs. Use this to look up user IDs needed for create_matter (responsible_attorney_id, originating_attorney_id) and other tools.
log_time_entrywrite actionCreate a new billable (or non-billable) time entry on a Clio matter. Use for time entries only; for expenses, hard costs, or soft costs use create_activity.
logoutLog out of Clio (clears local tokens)
matter_activity_summaryActivity snapshot for every open matter in one call: last note, last time entry, next calendar entry, open task count, and days since anything happened. Sorted by staleness, so matters with no recent file activity come first. Use this as the cheap first pass of a case-monitoring sweep, then look closely only at what it flags.
search_contactsSearch Clio contacts by name, email, or company
update_matterwrite actionUpdate one or more fields on an existing Clio matter
update_taskwrite actionUpdate one or more fields on an existing Clio task
upload_documentwrite actionUpload a local file to a Clio matter as a document
Public scan report
scanner v0.1.9 · 2026-09-20 · same rubric, same numbers if you re-run it
- Code scan65 source files scanned; 65 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 10 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
What the publisher says
From the Clio repository's README, as published. We do not edit it. Read it on GitHub
Clio MCP Server: Connect Claude to Clio Practice Management
### Built by Oktopeak: AI transformation & automation for law firms
Digital transformation for legal and healthcare businesses. We build AI integrations, workflow automation, and custom software your firm owns outright, including this connector. → Book a 30-min call
Open-source Model Context Protocol (MCP) connector that lets Claude read live data from Clio (matters, custom fields, notes, contacts, documents, folders, tasks, calendar, and billing) without copying client information into chat windows. Built for law firms that care about attorney-client privilege, ABA Opinion 512 compliance, and keeping AI workflows inside their existing practice management stack.
TL;DR: 36 Clio tools exposed to Claude across stdio and HTTP/SSE transports. Audit-logged for ABA Opinion 512. OAuth tokens encrypted at rest with AES-256-GCM. Local-only by default: you register your own Clio developer app, and no relay server sits in between. A separate one-click "listed" variant for the Clio App Directory uses a minimal login-only broker instead, see Listed / one-click install variant. MIT license, free forever.
Who this is for: Law firm IT, legal operations teams, tech-forward partners, and engineers at legal tech companies. If you can follow a five-step terminal install, you can use this.
[!TIP]
Not a developer? You don't need to be.
The README below assumes someone comfortable editing a JSON config file. If that's not you or your team, we deploy this for law firms: scoped credentials, audit log wired in, one custom workflow, training. A simpler one-command installer is also planned for v0.2.
→ See Guided MCP Setup, or book a 30-min call
Jump to: Demo · Setup · Available tools · Security & compliance · Need it deployed for you?
Demo
Watch Claude pull live data from Clio in under a minute (matters, contacts, tasks) without copying client information into chat.
▶ Watch the 60-second demo on YouTube
Setup tips + ABA Opinion 512 compliance updates for firms building with Claude + Clio.
→ Subscribe to Oktopeak Builder Notes. Short emails, easy unsubscribe.
Upgrading to 2.2.0
If you installed before September 2026 you are on 2.0.1, and there is one reason to upgrade that is worth stating plainly rather than burying in a changelog.
2.0.1 writes client data to its audit log. Contact search queries, note subjects, matter descriptions and custom field values were all recorded verbatim in ~/.clio-mcp/audit.log. The log is a plain file that nothing rotates. In 2.2.0 audit entries carry ids, counts, dates and page tokens only, enforced by an allowlist rather than a denylist, with a test that fails if any tool ever starts logging content again.
npm install -g @oktopeak/clio-mcp@2.2.0 # or just restart Claude Desktop if you use npxShortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y @oktopeak/clio-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add clio-mcp -- npx -y @oktopeak/clio-mcp
Clio: common questions
- Is Clio MCP server safe?
- Yes, by our scan: it is graded A (85/100). Read the Clio safety report
- How do I install Clio?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Clio need an API key?
- Yes. The registry entry asks for
CLIO_CLIENT_SECRET,ENCRYPTION_KEY. - Is Clio maintained?
- The last commit was 11 days ago (2026-09-10). The latest release is v2.2.0.