Skip to content
MCP server

Clio MCP

Let Claude read and update Clio matters, contacts, tasks and billing from your machine

Runs locallyStatus and history
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-mcp

Add 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)Required
  • CLIO_CLIENT_SECRETClient Secret from your Clio developer applicationRequired
  • ENCRYPTION_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.Required
  • ENCRYPTION_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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. New York LLC publication rules, deadline, county prices, clerks and notice text

    • 8 tools
    • Remote
    • Free
    • Legal and government
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government