practicepanther-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@practicepanther-mcp List open matters for account Acme Corp"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
PracticePanther MCP
Model Context Protocol (MCP) server for PracticePanther — cloud-based legal practice management software for solo and small-to-mid law firms.
Talk to PracticePanther from Claude, Cursor, or any MCP client. Read matters (cases), client accounts, contacts, time entries (billable hours), invoices, activities, tasks, calendar events — and create new records. Built against PracticePanther's public OAuth 2 + REST + OData API.
No existing MCP for PracticePanther — this is the first.
What you can do with it
You: "List open matters for account 'Acme Corp' and show last week's time entries."
Claude: *find_accounts → find_matters (odata filter status=open) → find_time_entries*
You: "Log 2.5 hours on matter 4421 for Sarah Lee today — research on the deposition brief."
Claude: *create_time_entry with matterId=4421, userId=<Sarah's>, date=today, hours=2.5,
description="Research: deposition brief", billable=true*
You: "Show all unpaid invoices over 60 days old across the firm."
Claude: *find_invoices (status=sent/overdue, startDate=2024-04-01) → summary*
You: "Book a hearing for matter 7788 on Friday May 30 at 2pm — judge Miller, courthouse 5."
Claude: *create_event with matterId=7788, startsAt, attendees, location*Related MCP server: ghl-mcp
Why this exists
PracticePanther's web UI is fine for solo use but doesn't expose firm-wide rollups (which matters are bleeding hours, which clients are slow-paying, who's about to blow a statute).
Logging billable hours from the UI requires click-through per entry — Claude can batch-log 10 entries in a single conversation.
The legal vertical has had Clio MCP servers for over a year; solo and small firms on PracticePanther had nothing equivalent.
For solo/small-firm attorneys, automating "what did I bill this week?" / "what's overdue?" / "log these 6 hours" is the most concrete, recurring time-save.
Install
pip install -e .Authenticate (one-time)
PracticePanther uses OAuth 2 authorization-code flow. The included helper script runs the full flow locally and prints the env vars to set:
practicepanther-mcp-auth --client-id <your_client_id> --client-secret <your_client_secret>This opens your browser, walks you through PracticePanther login, captures the redirect on http://localhost:8765/callback, exchanges the code for tokens, and prints:
export PRACTICEPANTHER_ACCESS_TOKEN="..."
export PRACTICEPANTHER_REFRESH_TOKEN="..."
export PRACTICEPANTHER_CLIENT_ID="..."
export PRACTICEPANTHER_CLIENT_SECRET="..."To register an OAuth app, contact PracticePanther support or your account manager — they issue client_id + client_secret per integration.
Configure
Once you have tokens, set them in your shell (or paste into the Claude Desktop config below):
export PRACTICEPANTHER_ACCESS_TOKEN="..."
export PRACTICEPANTHER_REFRESH_TOKEN="..."
export PRACTICEPANTHER_CLIENT_ID="..."
export PRACTICEPANTHER_CLIENT_SECRET="..."Refresh tokens last 60 days. The MCP client auto-refreshes the access token; when the refresh token expires, just re-run practicepanther-mcp-auth.
Use with Claude Desktop
{
"mcpServers": {
"practicepanther_mcp": {
"command": "practicepanther_mcp",
"env": {
"PRACTICEPANTHER_ACCESS_TOKEN": "...",
"PRACTICEPANTHER_REFRESH_TOKEN": "...",
"PRACTICEPANTHER_CLIENT_ID": "...",
"PRACTICEPANTHER_CLIENT_SECRET": "..."
}
}
}
}Tools (25)
Tool | Type | What it does |
| Diagnostic | Verifies credentials by listing users |
| Read | Search matters (cases) — supports OData |
| Read | Single matter with full detail |
| Write | Open new matter |
| Write | Patch matter fields |
| Read | Search client accounts |
| Read | Single client account |
| Write | New client account |
| Read | List contacts on accounts |
| Write | New contact |
| Read | The killer feature — billable hours across the firm |
| Read | Single time entry |
| Write | Log billable/non-billable time |
| Write | Patch time entry |
| Read | List invoices (filter by status, matter, account, date) |
| Read | Single invoice with line items |
| Write | New invoice |
| Read | Calls, emails, meetings |
| Write | Log activity against matter |
| Read | Tasks (to-dos) |
| Write | New task |
| Read | Calendar events (hearings, deadlines) |
| Write | New calendar event |
| Reference | Firm staff (attorneys, paralegals) |
| Reference | Practice areas (Family Law, PI, etc.) |
| Reference | Expense categories |
API coverage
Maps MCP tools to PracticePanther's OData-enabled REST API (/api/v2/*). The full surface is exposed via Swagger UI: https://app.practicepanther.com/swagger/ui/index.
This MCP exposes the resources a solo/small-firm attorney most often needs: matters, accounts, contacts, time entries, invoices, activities, tasks, calendar. Document management and trust accounting endpoints are intentionally out of scope for v0.1 — open an issue if you need them.
Rate limits
PracticePanther throttles at the OAuth-app level. The client auto-retries once on 401 (refreshes the access token) but does not retry on 429 — slow down if you hit rate limits.
Development
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest
ruff check src tests
practicepanther_mcpSee also
Need a custom MCP for your SaaS?
I build production-grade MCP servers for vertical SaaS — insurance, dental, veterinary, legal, property mgmt, home services. Typical engagement: 2-4 weeks, $25K-$120K. Source-owned, MIT-licensed, no vendor lock-in.
See sanjibani/mcp-services or email schoudhury1991@gmail.com.
Ships in the sanjibani vertical-MCP portfolio — see also hawksoft-mcp, open-dental-mcp, ezyvet-mcp, jobber-mcp, mcp-vertical-template.
MIT.
Acknowledgements
PracticePanther for the public REST + OData API + OAuth flow
Built using mcp-vertical-template
Inspired by sanjibani/hawksoft-mcp and the rest of the sanjibani vertical-MCP portfolio
Available Tools
26 toolscreate_accountA
Create a new client account. account_json is a JSON object string.
Minimum required: displayName.
Inputs: account_json (required). Returns: result
create_activityC
Log a new activity (call, email, meeting) against a matter.
Inputs: activity_json (required). Returns: result
create_contactC
Create a new contact. contact_json is a JSON object string.
Inputs: contact_json (required). Returns: result
create_eventC
Create a new calendar event. event_json is a JSON object string.
Inputs: event_json (required). Returns: result
create_invoiceC
Create a new invoice. invoice_json is a JSON object string.
Inputs: invoice_json (required). Returns: result
create_matterA
Open a new matter. matter_json is a JSON object string. Minimum
required fields: displayName, accountId, practiceAreaId,
responsibleAttorneyId, openDate.
Inputs: matter_json (required). Returns: result
create_taskC
Create a new task. task_json is a JSON object string.
Inputs: task_json (required). Returns: result
create_time_entryA
Log a billable or non-billable time entry. entry_json is a JSON object
string. Required: matterId, userId, date (YYYY-MM-DD),
hours, description. For billable entries also include rate and
billable: true.
Inputs: entry_json (required). Returns: result
find_accountsC
Search client accounts by name or email.
Inputs: top, name, skip, email, +2 more. Returns: result
find_activitiesC
List activities (calls, emails, meetings) on matters/accounts.
Inputs: top, skip, matter_id, account_id, +1 more. Returns: result
find_contactsC
List contacts associated with accounts (e.g. co-counsel, witnesses).
Inputs: top, skip, email, last_name, +2 more. Returns: result
find_eventsC
List calendar events (hearings, deadlines, meetings).
Inputs: top, skip, user_id, end_date, +2 more. Returns: result
find_invoicesB
List invoices. Filter by status (draft, sent, paid,
partially_paid, void, overdue) or by matter/account/date range.
Inputs: top, skip, status, orderby, +4 more. Returns: result
find_mattersB
Search matters (cases). Optional OData orderby, filter, select
let you write rich queries (e.g. orderby="openDate desc",
odata_filter="contains(displayName,'Smith')").
Inputs: top, skip, select, status, +5 more. Returns: result
find_tasksC
List tasks (to-dos) on matters.
Inputs: top, skip, status, matter_id, +1 more. Returns: result
find_time_entriesA
List time entries (billable hours). Use start_date + end_date for
a date range (ISO-8601, e.g. "2026-01-01"), matter_id for a single
case, user_id for a single attorney, billable to filter.
Inputs: top, skip, orderby, user_id, +4 more. Returns: result
get_accountA
Fetch a single client account with full detail.
Inputs: account_id (required). Returns: result
get_invoiceB
Fetch a single invoice with line items.
Inputs: invoice_id (required). Returns: result
get_matterA
Fetch a single matter with full detail (parties, practice area, status, etc.).
Inputs: matter_id (required). Returns: result
get_time_entryB
Fetch a single time entry.
Inputs: time_entry_id (required). Returns: result
health_checkA
Verify credentials by listing firm users. If this works, all other tools should work too.
Inputs: no named parameters. Returns: result
list_expense_categoriesA
List expense categories (Filing Fees, Travel, Copying, etc.).
Inputs: no named parameters. Returns: result
list_practice_areasA
List practice areas defined for the firm (e.g. Family Law, Personal Injury).
Inputs: no named parameters. Returns: result
list_usersA
List firm users (attorneys, paralegals, staff). Use to look up IDs for
responsible_attorney_id, user_id, assignee_id in other tools.
Inputs: no named parameters. Returns: result
update_matterB
Patch fields on a matter. updates_json is a JSON object with only the
fields you want to change (e.g. '{"status":"closed"}').
Inputs: matter_id (required), updates_json (required). Returns: result
update_time_entryB
Patch fields on a time entry (e.g. add narrative, adjust hours, mark billed).
Inputs: updates_json (required), time_entry_id (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 26 tools
Each tool targets a distinct entity or action (e.g., create_account vs create_contact, find_matters vs find_tasks). Verbs (create, find, get, list, update) clearly separate creation, search, retrieval, and modification. No two tools have overlapping purposes.
All tools follow a consistent verb_noun pattern: verbs are imperative (create, find, get, list, update, health_check) and nouns are plural for list/find operations (e.g., find_accounts, list_users) and singular for create/get/update (e.g., get_matter, create_invoice). No mixing of styles or unexpected abbreviations.
With 26 tools, the count is on the high end but justified for a comprehensive legal practice management system covering accounts, matters, contacts, activities, invoices, time entries, tasks, events, and reference lists. The scope is broad, and each tool serves a distinct purpose, making the count reasonable.
The server provides create, get/list/search for most entities but is missing update operations for accounts, contacts, activities, tasks, and events (only matter and time entry have update). There are no delete or archive tools, which are notable gaps for a CRUD-like lifecycle. Reference lists (expense categories, practice areas, users) are present but not modifiable.
Maintenance
Related MCP Connectors
Law firm management MCP: manage cases, clients, tasks, calendar and documents via Claude AI.
MCP server for generating rough-draft project plans from natural-language prompts.
Hosted MCP server for pre-action AI governance verdicts, model routing, and evidence verification.
41
Related MCP Servers
- AlicenseCqualityBmaintenanceMCP server for Bill4Time providing API coverage for legal billing and time tracking, enabling natural language interaction with clients, projects, time entries, invoices, payments, and more from Claude Desktop.591MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for GoHighLevel sub-accounts, enabling management of CRM contacts, pipelines, calendars, invoices, and more via natural language.-
- AlicenseNot gradedqualityCmaintenanceMCP server for Clio Manage that enables interaction with legal practice data including matters, contacts, activities, communications, tasks, documents, calendar entries, and bills via natural language.Apache 2.0
- AlicenseBqualityDmaintenanceMCP server for Moxie CRM that enables managing clients, projects, invoices, tasks, time tracking, expenses, and more through natural language.30MIT