Skip to main content
Glama
practicepanther-mcp

practicepanther-mcp

by sanjibani

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

health_check

Diagnostic

Verifies credentials by listing users

find_matters

Read

Search matters (cases) — supports OData $filter, $orderby, $select

get_matter

Read

Single matter with full detail

create_matter

Write

Open new matter

update_matter

Write

Patch matter fields

find_accounts

Read

Search client accounts

get_account

Read

Single client account

create_account

Write

New client account

find_contacts

Read

List contacts on accounts

create_contact

Write

New contact

find_time_entries

Read

The killer feature — billable hours across the firm

get_time_entry

Read

Single time entry

create_time_entry

Write

Log billable/non-billable time

update_time_entry

Write

Patch time entry

find_invoices

Read

List invoices (filter by status, matter, account, date)

get_invoice

Read

Single invoice with line items

create_invoice

Write

New invoice

find_activities

Read

Calls, emails, meetings

create_activity

Write

Log activity against matter

find_tasks

Read

Tasks (to-dos)

create_task

Write

New task

find_events

Read

Calendar events (hearings, deadlines)

create_event

Write

New calendar event

list_users

Reference

Firm staff (attorneys, paralegals)

list_practice_areas

Reference

Practice areas (Family Law, PI, etc.)

list_expense_categories

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_mcp

See 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

Available Tools

26 tools
create_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

    B3.3/5.0

    Scored across 26 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      MCP 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.
      59
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for GoHighLevel sub-accounts, enabling management of CRM contacts, pipelines, calendars, invoices, and more via natural language.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP 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
    • A
      license
      B
      quality
      D
      maintenance
      MCP server for Moxie CRM that enables managing clients, projects, invoices, tasks, time tracking, expenses, and more through natural language.
      30
      MIT