# Laserfiche MCP

> Laserfiche MCP is an open-source MCP server for files and documents. Search and read self-hosted Laserfiche documents from Claude, read-only by default. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, Windows, macOS, Linux
- **Repository:** https://github.com/adventist-gc/laserfiche-mcp
- **MCP Registry name:** io.github.adventist-gc/laserfiche-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

This server connects Claude Desktop, Claude Code or any MCP client to a self-hosted Laserfiche repository, and the same program also works as a command-line tool with commands such as ls, cat, search and dedupe. It is owned by the General Conference of Seventh-day Adventists and not affiliated with Laserfiche.

Search uses native Laserfiche queries or name patterns, can draft queries from your own templates and fields, and returns matching passages with page numbers from the OCR index, so many questions about scans need no download. Claude can also view images such as PNG and JPEG to describe and tag them, with a token-cost warning first. Text extraction covers PDF, Word, PowerPoint, email, HTML, RTF and plain text, and the server can compare entries and find byte-identical duplicates.

Writes are off until LF_READ_ONLY is set to false. When enabled, it can create, copy, move, rename, edit fields and tags and delete, with previews for deletes, renames and moves, folder fencing, allow-listed tools and capped bulk deletes. Laserfiche Cloud support is beta and unverified against a live tenant. It installs from PyPI or as a Desktop extension.

## Features

- **OCR passage search:** Returns matching passages with page numbers from the OCR index.
- **Document reading:** Extracts text from PDF, Office, email and other formats.
- **Image viewing:** Lets Claude describe and tag images, after a cost warning.
- **Duplicate finding:** Detects byte-identical files by size then content.
- **Opt-in writes:** Creates, edits, moves and deletes only when enabled.
- **Safety guardrails:** Previews destructive actions and caps bulk deletes.
- **Command-line mode:** Runs the same operations without AI.

## Good for

- Find which leases mention an unpaid balance
- Summarise the newest document in a folder
- Compare two scans to see whether they are the same record
- Find duplicate invoices and the space they use
- Approve field values across several entries

## Install

### Claude Code (Terminal)

```sh
claude mcp add laserfiche-mcp --env LF_REPO_API_URL='<LF_REPO_API_URL>' --env LF_REPOSITORY_ID='<LF_REPOSITORY_ID>' --env LF_USERNAME='<LF_USERNAME>' --env LF_PASSWORD='<LF_PASSWORD>' -- uvx laserfiche-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "laserfiche-mcp": {
      "command": "uvx",
      "args": [
        "laserfiche-mcp"
      ],
      "env": {
        "LF_REPO_API_URL": "<LF_REPO_API_URL>",
        "LF_REPOSITORY_ID": "<LF_REPOSITORY_ID>",
        "LF_USERNAME": "<LF_USERNAME>",
        "LF_PASSWORD": "<LF_PASSWORD>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "laserfiche-mcp": {
      "command": "uvx",
      "args": [
        "laserfiche-mcp"
      ],
      "env": {
        "LF_REPO_API_URL": "<LF_REPO_API_URL>",
        "LF_REPOSITORY_ID": "<LF_REPOSITORY_ID>",
        "LF_USERNAME": "<LF_USERNAME>",
        "LF_PASSWORD": "<LF_PASSWORD>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "laserfiche-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "laserfiche-mcp"
      ],
      "env": {
        "LF_REPO_API_URL": "<LF_REPO_API_URL>",
        "LF_REPOSITORY_ID": "<LF_REPOSITORY_ID>",
        "LF_USERNAME": "<LF_USERNAME>",
        "LF_PASSWORD": "<LF_PASSWORD>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "laserfiche-mcp": {
      "command": "uvx",
      "args": [
        "laserfiche-mcp"
      ],
      "env": {
        "LF_REPO_API_URL": "<LF_REPO_API_URL>",
        "LF_REPOSITORY_ID": "<LF_REPOSITORY_ID>",
        "LF_USERNAME": "<LF_USERNAME>",
        "LF_PASSWORD": "<LF_PASSWORD>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "laserfiche-mcp": {
      "command": "uvx",
      "args": [
        "laserfiche-mcp"
      ],
      "env": {
        "LF_REPO_API_URL": "<LF_REPO_API_URL>",
        "LF_REPOSITORY_ID": "<LF_REPOSITORY_ID>",
        "LF_USERNAME": "<LF_USERNAME>",
        "LF_PASSWORD": "<LF_PASSWORD>"
      }
    }
  }
}
```

## FAQ

### Is it read-only?

By default yes. Writes require LF_READ_ONLY=false and destructive actions need a second confirmation.

### Does it support Laserfiche Cloud?

Support is beta and has never been verified against a live tenant.

### What does it need?

Python 3.10 or newer, a reachable Repository API Server and an account that can read the repository.

### Can I use it without Claude?

Yes. The same operations are available as a command-line tool with JSON output.

### Is Laserfiche MCP free?

Yes. Laserfiche MCP is open source, so you can use and self-host it for free.

### How do I add Laserfiche MCP to Claude Code?

Run this command in your terminal: claude mcp add laserfiche-mcp --env LF_REPO_API_URL='<LF_REPO_API_URL>' --env LF_REPOSITORY_ID='<LF_REPOSITORY_ID>' --env LF_USERNAME='<LF_USERNAME>' --env LF_PASSWORD='<LF_PASSWORD>' -- uvx laserfiche-mcp

### What are the best alternatives to Laserfiche MCP?

The closest alternatives to Laserfiche MCP are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and NeuroStack.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [NeuroStack](https://ai-powered.com/mcp/neurostack): NeuroStack is a freemium MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [SSRS2](https://ai-powered.com/mcp/ssrs2): SSRS2 is an MCP server for files and documents.
- [Digitalnz](https://ai-powered.com/mcp/digitalnz): Digitalnz is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/laserfiche-mcp-2
