rocketmatter-mcp

MCP server for Rocketmatter — full API coverage for legal practice management. Use Rocketmatter from Claude Desktop with natural language.

What you can do

• Matters — create, update, search, manage billing info, budgets, status, custom fields, court rules
• Clients & Contacts — full CRUD, search, custom fields, contact data
• Tasks — create, assign, complete, filter by matter or user
• Time & Expenses — log billable time and expenses, manage activity types, LEDES codes
• Timers — start, pause, bill running timers
• Invoices — generate invoices, record payments, process refunds, manage templates
• Calendar — appointments linked to matters, availability checks, date range queries
• Documents — manage document records, folders, versions, download keys, templates
• Trust Accounting — view trust balances per matter
• Rates — custom matter rates, tax rates, discounts, surcharges, interest rates
• Workflow — matter workflow statuses, apply transitions
• Reports — run and retrieve firm reports
• Search — global search across all entities
• Internal Messaging — direct messages, channels
• Court Rules — apply court rules, calculate deadlines
• Matter Templates — create matters from templates
• Recurring Billing — payment plans

Requirements

• Python 3.10+
• Claude Desktop (or any MCP-compatible client)
• Rocketmatter account at app.rocketmatter.net

Installation

pip install rocketmatter-mcp

Setup

rocketmatter-mcp-setup

This opens your browser to authorize via Rocketmatter OAuth. Log in, click Allow, and the script captures the callback and saves tokens automatically. No manual credential entry required.

Verify:

rocketmatter-mcp-verify

Claude Desktop Configuration

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

Credential storage

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

OS	Backend
macOS	Keychain
Windows	Credential Manager
Linux	Secret Service (GNOME Keyring / KWallet)

Secrets are saved under the service name rocketmatter-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 ROCKETMATTER_MCP_USE_KEYRING=0, credentials fall back to a ~/.rocketmatter-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 ROCKETMATTER_API_KEY exported in your shell overrides the file fallback without touching the keyring.

Authentication Notes

Rocketmatter uses the LCS API (API key + username/password). Tokens are stored at ~/.rocketmatter-mcp/tokens.json (chmod 600) and refreshed automatically. Access tokens expire in ~5 hours; the MCP handles refresh silently. If the token expires, re-run rocketmatter-mcp-setup.

Example usage in Claude

"Search my matters for Smith"

"Log 2 hours on matter 456 for drafting the complaint"

"Get all upcoming calendar events for matter 789"

"Run an invoice for matter 123"

"Show me the trust account balance for matter 456"

"Calculate court deadlines for rule 12 from 2026-06-01"

License

MIT