Clio MCP
Let Claude read and update Clio matters, contacts, tasks and billing from your machine
- Pricing
- Open source
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 2.5.0
- Listing updated
- 3 days ago
About Clio MCP
Clio MCP is an open-source MCP server for legal and government. It runs locally on your machine and is started by your AI client.
Built by Oktopeak for law firms, this stdio server runs locally with your own Clio developer application, so no relay server sits between Claude and the firm's data. OAuth tokens are encrypted at rest with AES-256-GCM and the key lives in the operating system keychain. Every tool call is written to an append-only audit log, which the README ties to ABA Opinion 512.
The registry entry counts 37 tools, twelve of which write to Clio (matters, notes, tasks, calendar entries, time entries, folders and document uploads). Setting READ_ONLY=true leaves those unregistered so Claude can read but never change anything. A CLIO_REGION setting selects the US, EU, Australian or Canadian Clio region.
Version 2.5.0 adds a command that exports a whole account, documents included, to your own computer. A separate listed variant for the Clio App Directory uses a hosted token broker instead of your own credentials. Oktopeak also offers a managed firm-wide setup, but the connector itself is free.
Install
Run in a terminal
claude mcp add clio-mcp --env CLIO_CLIENT_ID='<CLIO_CLIENT_ID>' --env CLIO_CLIENT_SECRET='<CLIO_CLIENT_SECRET>' --env ENCRYPTION_KEY='<ENCRYPTION_KEY>' -- npx -y @oktopeak/clio-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"clio-mcp": {
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"clio-mcp": {
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"clio-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"clio-mcp": {
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"clio-mcp": {
"command": "npx",
"args": [
"-y",
"@oktopeak/clio-mcp"
],
"env": {
"CLIO_CLIENT_ID": "<CLIO_CLIENT_ID>",
"CLIO_CLIENT_SECRET": "<CLIO_CLIENT_SECRET>",
"ENCRYPTION_KEY": "<ENCRYPTION_KEY>"
}
}
}
}Configuration
CLIO_CLIENT_IDClient ID from your Clio developer application (Settings → Developer Applications)RequiredCLIO_CLIENT_SECRETClient Secret from your Clio developer applicationRequiredENCRYPTION_KEYOptional. Leave unset to auto-generate a key stored in the OS keychain (or ~/.clio-mcp/key.hex as fallback on headless Linux/WSL2). If set, must be a 64-character hex string — it will be migrated to the OS keychain on first use.CLIO_REDIRECT_PORTLocal port for the OAuth callback listener (default: 5678). Change if 5678 is in use.CLIO_REGIONClio data region: 'us' (default, app.clio.com), 'eu' (eu.app.clio.com), 'au' (au.app.clio.com), or 'ca' (ca.app.clio.com). Controls the API and OAuth base URLs. Fixed at Clio account creation; must match the server your firm logs in to. Any other value stops startup.READ_ONLYOptional. 'true', '1' or 'yes' leaves the twelve write tools (create_matter, create_custom_field, create_note, create_task, update_task, complete_task, create_calendar_entry, log_time_entry, create_activity, update_matter, create_folder, upload_document) unregistered so Claude can read Clio but never change it. Works on both transports.CLIO_API_BASEAdvanced override for the Clio API base URL (e.g. https://eu.app.clio.com/api/v4). Takes precedence over CLIO_REGION.CLIO_AUTH_URLOverride the OAuth authorization endpoint (e.g. https://eu.app.clio.com/oauth/authorize).CLIO_TOKEN_URLOverride the OAuth token endpoint (e.g. https://eu.app.clio.com/oauth/token).TOKEN_BROKER_URLURL of Oktopeak's hosted token broker for the Clio App Directory listed install. Do not set CLIO_CLIENT_ID/CLIO_CLIENT_SECRET alongside this — the shared app's secret lives only on the broker, never on this machine.RequiredENCRYPTION_KEYOptional. Leave unset to auto-generate a key stored in the OS keychain (or ~/.clio-mcp/key.hex as fallback on headless Linux/WSL2). If set, must be a 64-character hex string — it will be migrated to the OS keychain on first use.
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- create_matter
- Creates a matter in Clio.
- create_custom_field
- Creates a custom field.
- create_note
- Creates a note.
- create_task
- Creates a task.
- update_task
- Updates a task.
- complete_task
- Marks a task complete.
- create_calendar_entry
- Creates a calendar entry.
- log_time_entry
- Logs a time entry.
- create_activity
- Creates an activity.
- update_matter
- Updates a matter.
- create_folder
- Creates a folder.
- upload_document
- Uploads a document.
What it does
- Read-only mode
- READ_ONLY leaves the twelve write tools unregistered.
- Audit logging
- Appends every tool call to a log aimed at ABA Opinion 512.
- Encrypted tokens
- OAuth tokens stored with AES-256-GCM, key kept in the OS keychain.
- Regional support
- Targets Clio's US, EU, Australian and Canadian regions.
- Full account export
- Copies matters, contacts, notes, tasks, bills and documents to local disk.
- Local OAuth flow
- An authenticate tool opens a browser login on a local callback port.
Good for
- Ask Claude for open matters, tasks or calendar items in Clio
- Draft and log time entries from notes
- Create matters and tasks from an email
- Take a local backup of an entire Clio account
- Give a firm a read-only AI view of its practice data
Pricing
Open source
MIT licensed and free; Oktopeak sells a managed firm plan at $300 a month
Prices change. Check oktopeak.com before you buy.
Clio MCP FAQ
Do I need my own Clio developer app?
Yes for the standard install: you supply a client ID and secret from Settings, Developer Applications. The App Directory variant uses a hosted token broker instead.
Can I stop Claude from changing data?
Yes. Set READ_ONLY to true and the write tools are not registered.
What licence is it under?
MIT, and it is on npm as @oktopeak/clio-mcp.
Does data go through a third-party server?
In the standard install no relay sits in between; the listed variant uses a login-only broker.
Is Clio MCP free?
Yes. Clio MCP is open source, so you can use and self-host it for free.
How do I add Clio MCP to Claude Code?
Run this command in your terminal: claude mcp add clio-mcp --env CLIO_CLIENT_ID='<CLIO_CLIENT_ID>' --env CLIO_CLIENT_SECRET='<CLIO_CLIENT_SECRET>' --env ENCRYPTION_KEY='<ENCRYPTION_KEY>' -- npx -y @oktopeak/clio-mcp
What are the best alternatives to Clio MCP?
The closest alternatives to Clio MCP are Ha MCP, Concord MCP, note1, NY LLC Publication (FileMyPublication) and CalderFlow.
Alternatives to Clio MCP

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government