Mycase

PyPI version Python 3.10+ License: MIT

MCP server for MyCase — gives Claude full access to your law firm's MyCase account.

112 tools. One setup command.

What It Does

• Read and manage cases, clients, contacts, and companies
• Create and update tasks, events, and calendar entries
• Log time entries, expenses, and manage invoices
• Access case notes, documents, folders, and custom fields
• Manage leads, lead intake, and referral sources
• Message thread access and call logging
• Webhooks, people groups, practice areas, and more

Requirements

• Python 3.10+
• A MyCase developer app (see setup below)
• Claude Desktop or any MCP-compatible client

Before You Start — Register the Redirect URI

The OAuth flow uses http://127.0.0.1:8766/callback as the redirect URI. You must register this URI in your MyCase developer app settings before running setup. Without it, authorization will fail.

If you don't have a MyCase developer app yet, contact MyCase support or your account manager to request API access.

Installation

pip install mycase-mcp

Setup (5 steps)

1. Register redirect URI in your MyCase app: http://127.0.0.1:8766/callback

2. Run setup:

   mycase-mcp-setup
   

   Enter your Client ID and Client Secret when prompted. Your browser will open for MyCase authorization.

3. Verify:

   mycase-mcp-verify
   

4. Add to Claude Desktop config (see below)

5. Restart Claude Desktop

Claude Desktop Config

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mycase": {
      "command": "mycase-mcp"
    }
  }
}

Restart Claude Desktop after saving the config.

Troubleshooting

"No code received" after authorizing in browser → The redirect URI http://127.0.0.1:8766/callback is not registered in your MyCase app. Add it and try again.

Token exchange failed (401) → Double-check your Client ID and Client Secret. Re-run mycase-mcp-setup.

"Missing credentials" on verify → Run mycase-mcp-setup first. Credentials are saved to ~/.mycase-mcp/.

Claude doesn't see the mycase tools → Make sure you restarted Claude Desktop after editing claude_desktop_config.json.

429 Too Many Requests → The server retries automatically (up to 3 times). If it persists, wait a moment and retry.

Credential storage

By default credentials are stored in your operating system's native secret store via the cross-platform keyring library:

Secrets are saved under the service name mycase-mcp. Nothing is written to disk in clear text.

File fallback. On a host with no keyring backend (e.g. a headless Linux box without Secret Service), or if you set MYCASE_MCP_USE_KEYRING=0, credentials fall back to a ~/.mycase-mcp/.env file with 0600 permissions.

Read order. Credentials resolve in the order OS keyring → process environment → .env file. So a rotated secret in the keyring always wins, and a MYCASE_CLIENT_ID / MYCASE_CLIENT_SECRET exported in your shell overrides the file fallback without touching the keyring.

OAuth tokens are stored separately at ~/.mycase-mcp/tokens.json (mode 600) and refreshed automatically on expiry.

Tools

License

MIT