# Clio MCP

> Clio MCP is an open-source MCP server for legal and government. Let Claude read and update Clio matters, contacts, tasks and billing from your machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://oktopeak.com/clio-mcp/
- **Repository:** https://github.com/oktopeak/clio-mcp
- **MCP Registry name:** io.github.oktopeak/clio-mcp
- **Categories:** legal and government, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/clio-mcp-2
