Oktopeak

[ FIRST OPEN-SOURCE · MIT · ABA 512 ]

Filevine MCP Server — open-source Claude + Filevine integration

The first open-source Filevine MCP server. Connect Claude AI directly to your Filevine cases, contacts, documents, tasks, and custom collections in minutes. 15 tools, schema discovery for PI-specific sections, ABA Opinion 512 audit logging baked in, MIT licensed. On npm and the official Anthropic MCP Registry.

View on GitHub

15 tools

cases, contacts, notes, docs, tasks, collections

Schema-aware

discovers your firm's custom PI sections

ABA 512

append-only audit logging

[ REAL FIRMS, REAL RECEIPTS ]

100+ Filevine installs from npm · 30 days 1.3k+ across our four connectors Listed on Anthropic's MCP Registry MIT licensed — read every line

★★★★★

“Everything was done professionally, with efficient and fast communication, unconditional availability, kindness and professionalism.”

Goran Dojčinović Lawyer, Dojčinović Law Office

Verified review · Clutch, 5.0

“It’s very commendable — significant time went into that. Thank you both for open-sourcing it.”

Alexander W. Ostheimer-Lebeau Founder & Director, family-law firm (Ontario)

On our Clio connector · June 2026

Running on live dockets

A solo attorney found the connector on npm, installed it himself, ran Claude against his active matters, and emailed us a technically precise bug report the same week. The fix shipped. That is what real usage looks like.

[ QUICK INSTALL ]

Three steps, no browser OAuth dance

1. Install from npm

npm install -g @oktopeak/filevine-mcp

2. Generate credentials in Filevine, then add to your Claude config

{
  "mcpServers": {
    "filevine": {
      "command": "npx",
      "args": ["-y", "@oktopeak/filevine-mcp"],
      "env": {
        "FILEVINE_CLIENT_ID": "your-client-id",
        "FILEVINE_CLIENT_SECRET": "your-client-secret",
        "FILEVINE_PAT": "your-personal-access-token",
        "FILEVINE_REGION": "us"
      }
    }
  }
}

The personal access token comes from Filevine Settings → Access Tokens; the Client ID and Secret from Settings → Client Secrets. Your account needs API access enabled. Canadian firms set FILEVINE_REGION to ca.

3. Inside Claude, run the authenticate tool

The server exchanges your token, discovers your Filevine org and user IDs automatically, and encrypts everything at rest with AES-256-GCM. No browser pop-up, no callback URL. From this point Claude can read your cases, contacts, notes, documents, tasks, and custom collections on demand, and every call lands in the audit log.

[ MORE THAN ONE ATTORNEY? ]

Setting this up for the whole firm?

The install above is one laptop, one login — right for a solo attorney or a first test. A firm means repeating it on every machine, with no shared record of who did what. We deploy the same connector from one place your firm controls: each attorney signs in as themselves, and there is one audit log for the whole firm.

[ WHAT MAKES IT DIFFERENT ]

Built for how PI firms actually configure Filevine

Schema discovery

Medical records, liens, settlements, and treatment providers live in custom collection sections that differ per firm. The discover-schema tool maps your firm's actual sections and field names before anything gets queried, so Claude works with your real structure instead of a guessed one.

ABA 512 audit logging

Every Claude tool call is logged append-only at ~/.oktopeak-filevine/audit.log with timestamp, tool name, arguments (secrets redacted), outcome, user ID, and case ID. Mapped to ABA Formal Opinion 512 obligations. The artifact a state bar would request.

Conservative by design

Write access is scoped to notes and tasks only; no silent mutations to cases, contacts, or documents. Tokens encrypted at rest with AES-256-GCM. Built-in token-bucket rate limiting with exponential backoff keeps the connector inside Filevine's API limits automatically.

[ REPORTS & DATA ]

MCP is one of five ways to get data out of Filevine

Plain-English questions are what this connector is for. Standing dashboards are not: reports and vitals endpoints allow roughly 5 requests a minute, so bulk analytics belongs on DataBridge feeding Power BI or Looker. We wrote the honest map of every pathway, including where each one breaks.

Read the Filevine reporting guide

[ PRIVILEGE-SAFE DEPLOYMENT ]

Want to run this with a local LLM instead of consumer Claude?

For firms with maximum confidentiality requirements, the same Filevine MCP server pairs with LM Studio or Continue.dev running a local model on your hardware. No data leaves your firm. Full guide is the Privilege Stack post.

Read the Privilege Stack guide

[ FAQ ]

Filevine MCP Server — frequently asked

An open-source Model Context Protocol implementation that connects Claude AI (or any MCP-compatible client) directly to Filevine case management. 15 tools across cases, contacts, notes, documents, tasks, and custom collections, with schema discovery for PI-specific sections. The first open-source Filevine MCP connector. Published on npm as @oktopeak/filevine-mcp, listed on the official Anthropic MCP Registry as io.github.oktopeak/filevine-mcp. MIT licensed.
Three steps: npm install -g @oktopeak/filevine-mcp, generate a personal access token and client credentials inside Filevine Settings, then add the server to your Claude Desktop or Claude Code config and call the authenticate tool. No browser OAuth flow; org and user IDs are discovered automatically. Full guide on GitHub.
No. The server runs locally, talks directly to the Filevine API, and hands results to Claude inside your local session. Nothing routes through Oktopeak servers, nothing is cached locally, and no data trains external models. Tokens are encrypted at rest with AES-256-GCM.
Schema discovery. Filevine firms store medical records, liens, and settlements in custom sections that differ per firm, so the discover-schema tool maps your actual sections and field names first, and get-collection fetches data using those discovered selectors. No assumed layout.
The connector is free under MIT license; you need a Filevine account with API access enabled and a Claude subscription. Want it deployed for your firm with scoped credentials and the audit log wired into your stack? The Guided Setup is scoped to your firm, and custom builds on the Filevine integration service run from $12K. Or book a 30-minute call to scope it.
Ad-hoc questions, yes: "which cases have had no note activity in 30 days" gets answered without building a report. Standing dashboards, no: the connector inherits Filevine's API limits, including ~5 requests per minute on reports/vitals endpoints, so bulk analytics belongs on DataBridge feeding Power BI or Looker. The Filevine custom reporting guide maps every pathway.

Still have questions?

Talk with a friendly expert

[ GET STARTED ]

Start with the free connector. Hire us if you need help.

Two paths: install the OSS yourself (free, MIT, on GitHub), or have us deploy it in your firm with scoped credentials, the audit log destination wired into your stack, and a workflow designed with your team.

Takes about a minute, and you get the credential checklist your firm needs either way. Or book a 30-minute call instead.