Questlaw Library

QuestLaw Library MCP

• QuestLaw Library MCP
• Overview
• Quick start
• Set up and install
• Using the server
• Development and release
• License

Overview

A read-only MCP server that lets an AI client search and read your QuestLaw research library.

Project status

QuestLaw MCP is an experimental, open-source project for connecting your QuestLaw library to AI tools.

The server decrypts your library on your own machine, from a .qlvault export generated via the extension. It is read-only and makes no network connections.

Disclaimer

This project is not part of the official, supported QuestLaw product suite.

Using it decrypts your library on your computer and gives the readable contents to the AI client you connect it to. That client sends what it reads to its provider. The server itself sends nothing anywhere, but it cannot control what the client or the provider does with what it receives. Please use it with that in mind, and read SECURITY.md before you connect a library that holds sensitive information.

How it works

1. In QuestLaw, use the Export tool to create an encrypted file of your library (questlaw-backup- .qlvault).
2. The server looks for the newest export file in the folder you choose.
3. It decrypts the file _in memory_ with your account key. Your library is never written to disk unencrypted.
4. It builds a search index and answers tool calls.

QuestLaw extension          your machine                         AI client

+--------------+ +---------------------------+ +----------+ | encrypted | export | questlaw-library-mcp | stdio | Claude, | | library |----------->| |<------>| ChatGPT, | | (IndexedDB) | .qlvault | 1. reads the export | MCP | ... | +--------------+ file | 2. unwrap with your key | +----------+ | 3. decrypt in memory | account key --------->| 4. build a search index | (OS secret store) | 5. answer tool calls | +---------------------------+ no network connections, no writes

Quick start

npx -y questlaw-mcp@0.5.2 setup

setup shows the disclosure and asks you to accept it, stores your account key in the OS secret store, finds your newest export, test-decrypts it, and prints the configuration for your client. To check an install later:

npx -y questlaw-mcp@0.5.2 doctor

From a clone, run the same commands as node bin/questlaw-library-mcp.js setup and node bin/questlaw-library-mcp.js doctor. Once doctor passes, choose an install method below.

Set up and install

Requirements

• Node.js 20 or newer. Version 24 or newer is preferred.
• A QuestLaw library export. See Getting your library out of QuestLaw.
• Your 43-character account key. See Your account key.
• An MCP client. For example, Claude Desktop, Claude Code, Codex, or any client that supports MCP over stdio. ChatGPT requires a Secure MCP Tunnel.

Getting your library out of QuestLaw

In the extension, choose export a backup. An encrypted library produces a file named questlaw-backup- .qlvault. If you turn on daily backup in the extension's settings, the extension writes a new file each day, so the AI client sees recent research without any work from you.

By default, the server reads the newest .qlvault in ~/Downloads. To change that, set QUESTLAW_VAULT_FILE to a specific file or to a different folder.

The server reads a copy of your library from the time of the export, not your live library. If you add research after the export, the model can't see it until you export again.

Word add-in users: this server reads only the .qlvault export. It has no

access to your Word documents, and using it with Microsoft Copilot does not change that.

Your account key

An export's vault key is wrapped with your 43-character account key, so the server needs that key to open an export. Get it from the extension, under Settings, Encrypted library, Show account key, and then store it:

npx -y questlaw-mcp@0.5.2 setup

Where the key is kept

On macOS and Linux, the key is passed to the store on stdin. On Windows, it is passed through the child process environment. It never appears in a command line.

The account key opens every export of your library, so treat it like a password. You can supply it through QUESTLAW_RECOVERY_CODE instead, but the server ignores that variable unless you also set QUESTLAW_ALLOW_ENV_KEY=1.

Install

Claude Code plugin

The plugin includes the server and a skill that explains to the model how search works. Download questlaw-mcp-claude-plugin- .zip from Releases, or build it with npm run plugin.

Upload the ZIP through Claude's Plugins, Upload plugin control (under Customize or Settings, depending on the client). The same ZIP works for Claude Desktop plugin uploads, Cowork, and Claude Code. The local MCP server runs in Cowork and Claude Code, and plugin skills also work in chat. See Anthropic's plugin guide.

The plugin takes no configuration. It reads the newest .qlvault in ~/Downloads, the key from the default account in the secret store, and the consent that setup recorded. Run setup before you upload it.

To replace an installed copy, uninstall it before you upload the new archive:

claude plugin uninstall questlaw-library

Claude Desktop

• Plugin upload: use questlaw-mcp-claude-plugin- .zip, as described above.
• Desktop extension: use questlaw-mcp-claude-desktop- .mcpb from Releases, or build it with npm run bundle. Install it through Desktop's extension installer, and type i-understand in the required disclosure field.

Either way, store your key first with setup.

Claude Code without the plugin

claude mcp add questlaw-library -- npx -y questlaw-mcp@0.5.2

Codex

codex mcp add questlaw-library -- npx -y questlaw-mcp@0.5.2

Or add it to ~/.codex/config.toml directly:

[mcp_servers.questlaw-library]

command = "npx" args = ["-y", "questlaw-mcp@0.5.2"]

[mcp_servers.questlaw-library.env] QUESTLAW_VAULT_FILE = "/absolute/path/to/export_folder"

Codex saves env values in config.toml as plain text. Put your export path there if you like, but keep the account key in the OS secret store. The QUESTLAW_ALLOW_ENV_KEY setting exists to stop the key from ending up in a file like this one.

The ChatGPT desktop app includes the Codex engine and reads the same ~/.codex/config.toml. If you add the server through Codex, it works in the Codex part of the desktop app, but not in ordinary ChatGPT chats. For those, see the next section.

ChatGPT

ChatGPT can't start a local server itself. Instead, it connects through OpenAI's Secure MCP Tunnel, a connection that only goes outbound from your machine. You need developer mode in ChatGPT and access to the OpenAI developer platform.

One-time setup:

1. On platform.openai.com, create a tunnel (its ID starts with tunnel_) and a runtime API key.
2. Install tunnel-client, either from that page or with brew install tunnel-client.
3. Create a profile. Replace the tunnel ID and both paths with your own:

export CONTROL_PLANE_API_KEY="sk-..."

tunnel-client init \ --sample sample_mcp_stdio_local \ --profile questlaw \ --tunnel-id tunnel_YOUR_TUNNEL_ID \ --mcp-command "/path/to/node /absolute/path/to/questlaw-mcp/bin/questlaw-library-mcp.js"

tunnel-client doctor --profile questlaw --explain

1. In ChatGPT, turn on Settings, Security and Login, Developer mode.
2. In ChatGPT on the web, create a developer mode app, choose Tunnel as the connection, and pick the tunnel you created. At the time of writing, this option is available on the web but not in the desktop app.

Each time you want to use it, start the tunnel and leave it running:

tunnel-client run --profile questlaw

The tunnel client starts the MCP server for you. To check that both are running:

pgrep -fl "tunnel-client|questlaw-library-mcp"

Any other stdio MCP client

{

"mcpServers": { "questlaw-library": { "command": "npx", "args": ["-y", "questlaw-mcp@0.5.2"] } } }

Add an env block only to change a default:

{

"mcpServers": { "questlaw-library": { "command": "npx", "args": ["-y", "questlaw-mcp@0.5.2"], "env": { "QUESTLAW_VAULT_FILE": "/absolute/path/to/export_folder" } } } }

The version is pinned so an install runs exactly the release you checked. To upgrade, change the version in your client configuration.

Default file locations:

The setup command prints the exact configuration for your machine.

Checking an install

npx -y questlaw-mcp@0.5.2 doctor

  ok   vendored modules: 4 verified, from questlaw-extension @ 58d523c9 (synced 2026-10-07)

ok disclosure: accepted 2026-09-14T22:09:34.603Z ok account key: found in login keychain as "default" ok library export: questlaw-backup-2026-09-09.qlvault, 2.01 MiB, exported 11 days ago ok decrypt: 341 records in 354ms -- 32 cases, 4 projects, 6 relationships, ...

5 passed, 0 warnings, 0 failing

Using the server

Available tools

| library_overview | none | What the library holds, its projects, courts, and tags, and the export date