Lawmatics MCP Server

by oktopeakio.github.oktopeak/lawmatics-mcpv1.0.0

Connect Claude to Lawmatics: matters, contacts, pipelines, tasks, forms, custom fields, invoices.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active30d ago

Install Lawmatics MCP server

claude mcp add lawmatics -e LAWMATICS_ACCESS_TOKEN='<lawmatics-access-token>' -e LAWMATICS_CLIENT_SECRET='<lawmatics-client-secret>' -- npx -y @oktopeak/lawmatics-mcp

{
  "mcpServers": {
    "lawmatics": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/lawmatics-mcp"
      ],
      "env": {
        "LAWMATICS_ACCESS_TOKEN": "<lawmatics-access-token>",
        "LAWMATICS_CLIENT_SECRET": "<lawmatics-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "lawmatics": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/lawmatics-mcp"
      ],
      "env": {
        "LAWMATICS_ACCESS_TOKEN": "<lawmatics-access-token>",
        "LAWMATICS_CLIENT_SECRET": "<lawmatics-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "lawmatics": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/lawmatics-mcp"
      ],
      "env": {
        "LAWMATICS_ACCESS_TOKEN": "<lawmatics-access-token>",
        "LAWMATICS_CLIENT_SECRET": "<lawmatics-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "lawmatics": {
      "command": "npx",
      "args": [
        "-y",
        "@oktopeak/lawmatics-mcp"
      ],
      "env": {
        "LAWMATICS_ACCESS_TOKEN": "<lawmatics-access-token>",
        "LAWMATICS_CLIENT_SECRET": "<lawmatics-client-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
LAWMATICS_ACCESS_TOKEN	yes	yes	Lawmatics OAuth access token (never expires). Obtain once with `npx @oktopeak/lawmatics-mcp auth`.
LAWMATICS_READ_ONLY	—	—	Set to '1' to disable all write tools (create/update/tag/submit). Read-only mode for cautious firms.
LAWMATICS_EXPERIMENTAL_TOOLS	—	—	Set to '1' to enable experimental tools (set-matter-custom-fields) whose API request shape is not fully documented by Lawmatics.
LAWMATICS_RATE_LIMIT_PER_MIN	—	—	Client-side request throttle per minute (default: 50, the conservative documented per-firm limit; newer docs say 150).
LAWMATICS_AUDIT_LOG	—	—	Set to '0' to disable the local JSONL audit log (default path: ~/.lawmatics-mcp/audit.log).
LAWMATICS_AUDIT_LOG_PATH	—	—	Override the audit log file location (default: ~/.lawmatics-mcp/audit.log). The log contains tool arguments, which can include client data.
LAWMATICS_CLIENT_ID	—	—	Only needed for the one-time `auth` command: your Lawmatics developer app client ID.
LAWMATICS_CLIENT_SECRET	—	yes	Only needed for the one-time `auth` command: your Lawmatics developer app client secret.
LAWMATICS_REDIRECT_PORT	—	—	Local port for the one-time OAuth callback (default: 5678). Must match the app's Callback URL.
LAWMATICS_API_BASE	—	—	Override the Lawmatics API base URL (default: https://api.lawmatics.com/v1).

Freshness

Active — last maintenance signal 30d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-09 · 30d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-08-08 · 2mo ago · official registry · v1.0.0

FAQ

›How do I install the Lawmatics MCP server in Claude Code?

Run: claude mcp add lawmatics -e LAWMATICS_ACCESS_TOKEN='<lawmatics-access-token>' -e LAWMATICS_CLIENT_SECRET='<lawmatics-client-secret>' -- npx -y @oktopeak/lawmatics-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Lawmatics require an API key?

Yes. It expects LAWMATICS_ACCESS_TOKEN, LAWMATICS_CLIENT_SECRET, of which 2 are secrets.

›Can I use Lawmatics as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Lawmatics in the official MCP registry?

Yes, as io.github.oktopeak/lawmatics-mcp.