# Lawcus MCP by usefulapi

> Lawcus MCP by usefulapi is an MCP server. Read Lawcus contacts, matters, leads, time and billing reports; create contacts and tasks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/lawcus/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/lawcus
- **MCP Registry name:** io.usefulapi/lawcus
- **Listing updated:** 2026-11-13

## About

Read Lawcus contacts, matters, leads, time and billing reports; create contacts and tasks.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http lawcus https://lawcus.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://lawcus.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "lawcus": {
      "url": "https://lawcus.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "lawcus": {
      "type": "http",
      "url": "https://lawcus.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "lawcus": {
      "serverUrl": "https://lawcus.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "lawcus": {
      "type": "http",
      "url": "https://lawcus.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `lawcus_get_me`: Lawcus: the user the API token belongs to (id, uuid, name, timezone, role such as OWNER/ADMIN/MEMBER).
- `lawcus_get_firm`: Lawcus: the firm (team) details: name, address, currency, locale and phone numbers.
- `lawcus_list_team_members`: Lawcus: the people on the firm's team with id, uuid, name, role and hourly rate. Ids are used in matter, task and report filters.
- `lawcus_search`: Lawcus: global search across contacts, matters and leads for a keyword.
- `lawcus_list_contacts`: Lawcus: list contacts (people and companies; clients are contacts), filterable by name, email, type or update date. Paged with skip/take.
- `lawcus_get_contact`: Lawcus: one contact by UUID, with addresses, phones, emails and custom fields.
- `lawcus_create_contact`: WRITE: create a new contact in Lawcus (a person or a company). It does not send anything to the contact. Person needs first_name and last_name; Company needs name. Check lawcus_list_contacts first to avoid duplicates.
- `lawcus_list_matters`: Lawcus: list matters (cases) with status, client, billing type, trust and retainer balances. Filter by status, name, number, client or dates. Paged with skip/take; the reply also carries opened/closed counts.
- `lawcus_get_matter`: Lawcus: one matter by UUID with its client, workflow stage, billing settings, balances and custom fields.
- `lawcus_list_leads`: Lawcus: list leads (prospective matters) with client contact details and pipeline stage. Paged with skip/take.
- `lawcus_get_lead`: Lawcus: one lead by UUID.
- `lawcus_list_lead_sources`: Lawcus: the firm's lead sources (Website, Referral, Google, ...). Ids go into lead and contact filters.
- `lawcus_list_workflows`: Lawcus: the workflows (matter and lead pipelines) with their ids.
- `lawcus_list_workflow_stages`: Lawcus: the stages of one workflow (pipeline).
- `lawcus_list_tasks`: Lawcus: list tasks, optionally by completion, assignee, matter or tag. The API returns the whole list; the reply is cut to `limit`.
- `lawcus_create_task`: WRITE: create a task in Lawcus, optionally on a matter and assigned to team members. Lawcus may email or SMS the assignees if reminders are set; no reminders are set by this tool.
- `lawcus_list_time_entries`: Lawcus: time entries (hours worked, rate, total, matter, invoiced or not). The API returns all entries; filter here by matter and date range, reply cut to `limit`.
- `lawcus_list_expenses`: Lawcus: expenses logged against matters. The API returns all expenses; filter here by matter and date range, reply cut to `limit`.
- `lawcus_list_billing_items`: Lawcus: billable activity (time entries, expenses and flat fees) with payment details, filterable by date range, user, practice area, matter, client and invoiced state. Also returns time totals for today/week/month/year.
- `lawcus_list_interactions`: Lawcus: logged client interactions (emails, calls, secure messages) with subject, matter and contact. Paged with skip/paginate.
- `lawcus_report_accounts_receivable`: Lawcus report (needs the Admin role): unpaid invoices by age (who owes the firm what).
- `lawcus_report_matter_balance`: Lawcus report (needs the Admin role): balance summary of all matters, optionally trust balances only.
- `lawcus_report_revenue`: Lawcus report (needs the Admin role): revenue by attorney for a period.
- `lawcus_report_time_entries`: Lawcus report (needs the Admin role): time entries summarized per user for a period.
- `lawcus_report_payments_collected`: Lawcus report (needs the Admin role): payments the firm collected in a period.
- `lawcus_report_invoice_history`: Lawcus report (needs the Admin role): summary of issued invoices for a period.
- `lawcus_report_client_trust`: Lawcus report (needs the Admin role): client trust (IOLTA) balances; zero balances hidden unless display_zero is true.

## FAQ

### How do I add Lawcus MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http lawcus https://lawcus.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/lawcus-mcp-by-usefulapi
