Setup guide
How to Connect Claude to CourtListener via MCP
Free Law Project's official MCP server — search millions of court opinions, dockets, and judges from your AI assistant. This guide walks through connecting Free Law Project's official hosted MCP server to Claude Code, Claude Desktop, or any other MCP client.
Prerequisites
- Claude Code, Claude Desktop, or another MCP-compatible client
- A free CourtListener account for OAuth sign-in — no separate API key needed to get started
- Free with a CourtListener account; higher API limits with Free Law Project membership tiers
1. Install: Claude Code
Run this in your terminal:
claude mcp add --transport http courtlistener https://mcp.courtlistener.comOr: Claude Desktop, Cursor, and other MCP clients
Add this to your client's MCP configuration file:
{
"mcpServers": {
"courtlistener": {
"type": "http",
"url": "https://mcp.courtlistener.com"
}
}
}2. Authenticate
The server uses OAuth against your CourtListener account rather than a static API key. The first tool call from your client triggers a browser sign-in flow — approve it there, and the client stores the resulting session for future calls.
3. Test it
Once connected, ask Claude something you'd normally search CourtListener for directly — a case name, a circuit split question, or a docket lookup. A working connection returns cited opinions and docket data in the conversation instead of a tool-not-found error.
Troubleshooting
- Client can't reach the server. Confirm the transport is set to
httpand the endpoint is exactlyhttps://mcp.courtlistener.com— a typo in either silently fails on most clients rather than erroring clearly. - Requests get rate-limited. Free accounts have daily query limits; a paid Free Law Project membership raises the ceiling. This is a CourtListener account setting, not a client-side config option.
- Nothing happens after adding the config. Most MCP clients require a full restart (not just closing the window) to pick up a new server entry.
See the full CourtListener MCP listing for current pricing and details, or read our analysis of what the CourtListener connector means for litigators.
Custom AI for your firm
Off-the-shelf tools not quite right?
We build it for you.
NYClaw.io builds private MCP integrations tailored to your practice area, case management system, and existing workflows. Most firms are operational in under two weeks.
- ✓Works with Clio, MyCase, Filevine, PracticePanther, and custom systems
- ✓Your data stays in your infrastructure — MCP keeps it private by design
- ✓Fixed-scope engagements — no open-ended retainers required
Serving law firms in Westchester County, NYC, and remotely nationwide. No commitment required for the initial call.