← Index

io.github.oktopeak/clio-mcp

io.github.oktopeak/clio-mcp·v1.0.1·Other
Quality Score
85
/100

Connect Claude to Clio with 15 tools for matters, contacts, tasks, billing, and more.

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "clio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/clio-mcp"
      ],
      "env": {
        "CLIO_CLIENT_ID": "<clio_client_id>",
        "CLIO_CLIENT_SECRET": "<your-clio_client_secret>",
        "ENCRYPTION_KEY": "<your-encryption_key>",
        "CLIO_REDIRECT_PORT": "<clio_redirect_port>",
        "CLIO_REGION": "<clio_region>",
        "CLIO_API_BASE": "<clio_api_base>",
        "CLIO_AUTH_URL": "<clio_auth_url>",
        "CLIO_TOKEN_URL": "<clio_token_url>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "clio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/clio-mcp"
      ],
      "env": {
        "CLIO_CLIENT_ID": "<clio_client_id>",
        "CLIO_CLIENT_SECRET": "<your-clio_client_secret>",
        "ENCRYPTION_KEY": "<your-encryption_key>",
        "CLIO_REDIRECT_PORT": "<clio_redirect_port>",
        "CLIO_REGION": "<clio_region>",
        "CLIO_API_BASE": "<clio_api_base>",
        "CLIO_AUTH_URL": "<clio_auth_url>",
        "CLIO_TOKEN_URL": "<clio_token_url>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @oktopeak/clio-mcp
§02  Environment variables
CLIO_CLIENT_ID
required

Client ID from your Clio developer application (Settings → Developer Applications)

CLIO_CLIENT_SECRET
requiredsecret

Client Secret from your Clio developer application

ENCRYPTION_KEY
requiredsecret

64-character hex key for encrypting stored OAuth tokens (generate with: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))")

CLIO_REDIRECT_PORT

Local port for the OAuth callback listener (default: 5678). Change if 5678 is in use.

CLIO_REGION

Clio region: 'us' (default) or 'eu'. Controls API and auth base URLs.

CLIO_API_BASE

Override the Clio API base URL (e.g. https://eu.app.clio.com/api/v4). Use instead of CLIO_REGION for fine-grained control.

CLIO_AUTH_URL

Override the OAuth authorization endpoint (e.g. https://eu.app.clio.com/oauth/authorize).

CLIO_TOKEN_URL

Override the OAuth token endpoint (e.g. https://eu.app.clio.com/oauth/token).

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Other