Oktopeak

[ OPEN-SOURCE · MIT · ABA 512 ]

Clio MCP Server — open-source Claude + Clio integration

The first open-source Clio MCP server with ABA Opinion 512 audit logging built in. Connect Claude AI directly to your Clio practice management in five minutes. MIT licensed. On npm and the official Anthropic MCP Registry.

26 tools

matters, contacts, docs, tasks, calendar, billing

ABA 512

append-only audit logging

5 min

install with your Clio credentials

Claude Desktop answering a question with live Clio matter and calendar data (demo firm data)

[ REAL FIRMS, REAL RECEIPTS ]

300+ Clio installs from npm · 30 days 1.3k+ across our four connectors Listed on Anthropic's MCP Registry MIT licensed — read every line

★★★★★

“Everything was done professionally, with efficient and fast communication, unconditional availability, kindness and professionalism.”

Goran Dojčinović Lawyer, Dojčinović Law Office

Verified review · Clutch, 5.0

“It’s very commendable — significant time went into that. Thank you both for open-sourcing it.”

Alexander W. Ostheimer-Lebeau Founder & Director, family-law firm (Ontario)

On our Clio connector · June 2026

Running on live dockets

A solo attorney found the connector on npm, installed it himself, ran Claude against his active matters, and emailed us a technically precise bug report the same week. The fix shipped. That is what real usage looks like.

[ TWO WAYS TO RUN IT ]

Install it yourself, or have us put it in your firm

Install it yourself

Free under the MIT license, on npm and the official Anthropic MCP Registry. You need someone comfortable in a terminal, a Clio API application, and about five minutes. Nobody at Oktopeak touches your data or your credentials.

View on GitHub

We deploy it in your firm

We create the Clio API application, scope OAuth to what your team should reach, wire the audit log into wherever your firm keeps records, and design one working workflow with your attorneys. You own the result and the code.

Guided setup for firms

[ LIVE DEMO ]

See Claude actually working with Clio

Two short clips. The first shows Claude reading live case data, creating matters, booking calendar events, and closing tasks. The second is the install walkthrough.

Workflow demo

Claude creates matters, books calendar events, and closes tasks in Clio. Read + scoped write. Every tool call audit-logged.

Install walkthrough

From npm install to authenticated Claude session with live Clio data. Roughly five minutes.

Want this running against your firm's Clio?

We handle the API application, scoped OAuth, audit log destination, and one workflow built with your attorneys.

Guided setup for firms

[ QUICK INSTALL ]

Three commands, five minutes

1. Install from npm

npm install -g @oktopeak/clio-mcp

2. Add to your Claude Desktop or Claude Code MCP config

{
  "mcpServers": {
    "clio": {
      "command": "npx",
      "args": ["-y", "@oktopeak/clio-mcp"],
      "env": {
        "TRANSPORT": "stdio",
        "CLIO_CLIENT_ID": "your-clio-client-id",
        "CLIO_CLIENT_SECRET": "your-clio-client-secret"
      }
    }
  }
}

3. Inside Claude, run the authenticate tool

Claude calls the local OAuth flow, you confirm in your browser, the token gets encrypted at rest in your OS keychain, and the connector is ready. From this point Claude can read your Clio matters, contacts, documents, tasks, calendar, and billing data on demand.

[ MORE THAN ONE ATTORNEY? ]

Setting this up for the whole firm?

The install above is one laptop, one login — right for a solo attorney or a first test. A firm means repeating it on every machine, with no shared record of who did what. We deploy the same connector from one place your firm controls: each attorney signs in as themselves, and there is one audit log for the whole firm.

[ WHAT MAKES OURS DIFFERENT ]

The only Clio MCP server with ABA 512 audit logging built in

Diagram: Claude connects to the Clio MCP connector running on the attorney's own machine, which holds OS-keychain-encrypted credentials, writes an append-only audit log, and talks to Clio's API — nothing routes through Oktopeak
Claude ↔ connector (on your machine) ↔ Clio. Credentials encrypted in your OS keychain. Every call written to an append-only log.

ABA 512 audit logging

Every Claude tool call is logged append-only with timestamp, tool name, arguments, and result. Mapped to ABA Formal Opinion 512 obligations out of the box. Not a checkbox — a real log a state bar would accept.

OS keychain encryption

OAuth tokens encrypted with AES-256-GCM and stored in macOS Keychain, Linux secret-service, or Windows Credential Manager. Never plaintext. Never on our servers.

stdio + HTTP/SSE

Single-user stdio for Claude Desktop and Claude Code. Multi-session HTTP/SSE for shared deployment and for Claude Cowork or claude.ai custom connectors, which only accept remote MCP servers. Same tool surface either way.

Styled excerpt of the append-only ABA Opinion 512 audit log, showing timestamp, tool name, parameters, and result count for a demo firm
A real excerpt of the audit-log format (demo data) — what your bar would actually see.

Clio is one of four systems we've built this for — see the whole set in the MCP Connectors case study.

[ OTHER CLIO MCP OPTIONS ]

There are four open-source Clio MCP servers. They are not interchangeable.

If you're evaluating options, we wrote a frank feature-by-feature comparison covering LegalContext, lawquarter, LegalMCP, and ours. Yes, we placed ours first — and we explain where each alternative wins.

Read the full comparison

[ PRIVILEGE-SAFE DEPLOYMENT ]

Want to run this with a local LLM instead of consumer Claude?

For firms with maximum confidentiality requirements, the same Clio MCP server pairs with LM Studio or Continue.dev running a local model on your hardware. No data leaves your firm. Full guide is the Privilege Stack post.

Read the Privilege Stack guide

[ FAQ ]

Clio MCP Server — frequently asked

An open-source Model Context Protocol implementation that connects Claude AI (or any MCP-compatible client) directly to Clio practice management. 26 tools across matters, contacts, documents, tasks, calendar, time entries, billing, and audit-log export. Published on npm as @oktopeak/clio-mcp, listed on the official Anthropic MCP Registry as io.github.oktopeak/clio-mcp. MIT licensed.
Three steps: npm install -g @oktopeak/clio-mcp, add the server entry to your Claude Desktop or Claude Code MCP config with your Clio API credentials, then call the authenticate tool inside Claude to complete the local OAuth handshake. Full guide on GitHub.
Yes, with one deployment difference. Claude Cowork runs on Anthropic's servers, so it cannot launch the connector on your laptop the way Claude Desktop does. Instead, the connector runs in HTTP/SSE mode (built in since v2.0.0) as a hosted service that your firm adds in Cowork as a custom connector. The server has to be reachable from the internet, which makes this a small hosting job rather than a laptop install. That hosted pattern is exactly what our Firm-Wide Deployment engagement delivers.
The server runs locally on your machine. OAuth credentials are encrypted at rest in your OS keychain. Every Claude tool call is logged append-only locally. No client data routes through Oktopeak servers. For maximum privilege protection, pair it with a local LLM via the Privilege Stack guide.
As of May 2026, four open-source Clio MCP connectors exist (LegalContext, lawquarter, LegalMCP, Oktopeak) plus no-code options (Zapier, viaSocket, Pipedream). The Oktopeak connector is the only one shipping with ABA Opinion 512 audit logging by default. Full feature-by-feature comparison at /blog/clio-mcp-connectors-compared/.
The connector is free under MIT license. Claude Pro or Claude API is paid separately. If you want us to deploy it for you with scoped credentials, audit log wired into your stack, and a workflow built with your team, that is our guided setup for firms. For work that goes beyond the connector, see Clio integration services. Scope and price are set once we understand your firm, so book a 30-minute call and we will size it.
In practice, yes. The MCP server is what turns Claude into an AI agent for your firm: 26 scoped tools to read matters, draft from the file, and create tasks and calendar events inside your Clio, with an append-only ABA Opinion 512 audit log of every action. Claude asks for your confirmation before each write action, so nothing changes in your Clio without a human approving it.
No — it works with the Clio subscription you already have, on any plan with API access. If the bigger spend question is on your mind, we published the honest math: what Clio actually costs a firm over three years — worth reading before any renewal.

Still have questions?

Talk with a friendly expert

[ GET STARTED ]

Start with the free connector. Hire us if you need help.

Two paths: install the OSS yourself (free, MIT, on GitHub), or have us deploy it in your firm with scoped credentials, audit log destination, and a workflow designed with your team.

Takes about a minute, and you get the credential request your firm needs either way. Or book a 30-minute call instead.

We asked sixty lawyers what actually eats their day. The findings are free.