io.github.oktopeak/clio-mcp

{
  "_meta": {
    "io.modelcontextprotocol.registry/official": {
      "status": "active",
      "isLatest": true,
      "updatedAt": "2026-09-02T12:05:14.604048Z",
      "publishedAt": "2026-09-02T12:05:14.604048Z",
      "statusChangedAt": "2026-09-02T12:05:14.604048Z"
    }
  },
  "server": {
    "name": "io.github.oktopeak/clio-mcp",
    "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
    "version": "2.2.0",
    "packages": [
      {
        "version": "2.2.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@oktopeak/clio-mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "CLIO_CLIENT_ID",
            "format": "string",
            "isRequired": true,
            "description": "Client ID from your Clio developer application (Settings → Developer Applications)"
          },
          {
            "name": "CLIO_CLIENT_SECRET",
            "format": "string",
            "isSecret": true,
            "isRequired": true,
            "description": "Client Secret from your Clio developer application"
          },
          {
            "name": "ENCRYPTION_KEY",
            "format": "string",
            "isSecret": true,
            "description": "Optional. 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."
          },
          {
            "name": "CLIO_REDIRECT_PORT",
            "format": "string",
            "description": "Local port for the OAuth callback listener (default: 5678). Change if 5678 is in use."
          },
          {
            "name": "CLIO_REGION",
            "format": "string",
            "description": "Clio 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."
          },
          {
            "name": "READ_ONLY",
            "format": "string",
            "description": "Optional. 'true', '1' or 'yes' leaves the nine write tools (create_matter, create_note, create_task, update_task, complete_task, create_calendar_entry, log_time_entry, create_activity, upload_document) unregistered so Claude can read Clio but never change it. Works on both transports."
          },
          {
            "name": "CLIO_API_BASE",
            "format": "string",
            "description": "Advanced override for the Clio API base URL (e.g. https://eu.app.clio.com/api/v4). Takes precedence over CLIO_REGION."
          },
          {
            "name": "CLIO_AUTH_URL",
            "format": "string",
            "description": "Override the OAuth authorization endpoint (e.g. https://eu.app.clio.com/oauth/authorize)."
          },
          {
            "name": "CLIO_TOKEN_URL",
            "format": "string",
            "description": "Override the OAuth token endpoint (e.g. https://eu.app.clio.com/oauth/token)."
          }
        ]
      },
      {
        "version": "2.2.0",
        "transport": {
          "type": "stdio"
        },
        "identifier": "@oktopeak/clio-mcp",
        "registryType": "npm",
        "environmentVariables": [
          {
            "name": "TOKEN_BROKER_URL",
            "format": "string",
            "isRequired": true,
            "description": "URL 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."
          },
          {
            "name": "ENCRYPTION_KEY",
            "format": "string",
            "isSecret": true,
            "description": "Optional. 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."
          }
        ]
      }
    ],
    "repository": {
      "url": "https://github.com/oktopeak/clio-mcp",
      "source": "github"
    },
    "websiteUrl": "https://oktopeak.com/clio-mcp/",
    "description": "Connect Claude to Clio: 34 tools for matters, custom fields, notes, documents, folders, billing."
  }
}