courtlistener-mcp-server

Name: courtlistener-mcp-server
Author: cyanheads

cyanheads

Search and retrieve US court opinions, federal dockets, judge records, citation networks, and oral arguments from CourtListener's 9M+ opinion corpus via MCP. STDIO or Streamable HTTP.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

Local

claude mcp add courtlistener --env COURTLISTENER_API_TOKEN='<COURTLISTENER_API_TOKEN>' -- npx -y @cyanheads/courtlistener-mcp-server

~/.codex/config.toml

[mcp_servers.courtlistener]
command = "npx"
args = ["-y", "@cyanheads/courtlistener-mcp-server"]
env = { COURTLISTENER_API_TOKEN = "<COURTLISTENER_API_TOKEN>" }

# codex mcp add courtlistener --env COURTLISTENER_API_TOKEN='<COURTLISTENER_API_TOKEN>' -- npx -y @cyanheads/courtlistener-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "<COURTLISTENER_API_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "courtlistener": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "<COURTLISTENER_API_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "<COURTLISTENER_API_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "<COURTLISTENER_API_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/courtlistener-mcp-server"
      ],
      "env": {
        "COURTLISTENER_API_TOKEN": "<COURTLISTENER_API_TOKEN>"
      }
    }
  }
}

Remote

claude mcp add --transport http courtlistener https://courtlistener.caseyjhand.com/mcp

~/.codex/config.toml

[mcp_servers.courtlistener]
url = "https://courtlistener.caseyjhand.com/mcp"

# codex mcp add courtlistener --url https://courtlistener.caseyjhand.com/mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "courtlistener": {
      "url": "https://courtlistener.caseyjhand.com/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "courtlistener": {
      "type": "http",
      "url": "https://courtlistener.caseyjhand.com/mcp"
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "courtlistener": {
      "httpUrl": "https://courtlistener.caseyjhand.com/mcp"
    }
  }
}

claude_desktop_config.json · Customize › Connectors › Add custom connector

{
  "mcpServers": {
    "courtlistener": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://courtlistener.caseyjhand.com/mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "courtlistener": {
      "url": "https://courtlistener.caseyjhand.com/mcp"
    }
  }
}

Environment variables

COURTLISTENER_API_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Local

Remote

Environment variables

Related