clio-mcp

clio-mcp is a local MCP server: Connect Claude to Clio: 34 tools for matters, custom fields, notes, documents, folders, billing. Install it from npm as @oktopeak/clio-mcp.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add io-github-oktopeak-clio-mcp -e CLIO_CLIENT_ID=... -e CLIO_CLIENT_SECRET=... -e ENCRYPTION_KEY=... -e CLIO_REDIRECT_PORT=... -e CLIO_REGION=... -e READ_ONLY=... -e CLIO_API_BASE=... -e CLIO_AUTH_URL=... -e CLIO_TOKEN_URL=... -- npx -y @oktopeak/clio-mcp

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-oktopeak-clio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/clio-mcp"
      ],
      "env": {
        "CLIO_CLIENT_ID": "...",
        "CLIO_CLIENT_SECRET": "...",
        "ENCRYPTION_KEY": "...",
        "CLIO_REDIRECT_PORT": "...",
        "CLIO_REGION": "...",
        "READ_ONLY": "...",
        "CLIO_API_BASE": "...",
        "CLIO_AUTH_URL": "...",
        "CLIO_TOKEN_URL": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx) or Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: CLIO_CLIENT_ID, CLIO_CLIENT_SECRET, ENCRYPTION_KEY, CLIO_REDIRECT_PORT, CLIO_REGION, READ_ONLY, CLIO_API_BASE, CLIO_AUTH_URL, CLIO_TOKEN_URL, TOKEN_BROKER_URL