Laserfiche MCP server

<!-- mcp-name: io.github.SamuelSHernandez/laserfiche-mcp -->

laserfiche-mcp

Community project — not affiliated with or endorsed by Laserfiche.

A Model Context Protocol server that lets Claude (Desktop, Code, or any MCP client) search, read, and — when you opt in — write documents in a self-hosted Laserfiche repository. The same binary is also a full command-line client (ls, get, cat, search, manifest, dedupe, ...) for the deterministic work that needs no model at all.

Current release v2.3.0 — read and write tools for self-hosted Repository API v1 and v2, a one-click Claude Desktop extension, an optional remote HTTP transport with per-user OAuth for web clients, and a full CLI (ls, get, cat, search, manifest, dedupe, ...) for the deterministic work that needs no model at all. Read-only by default; write tools register only with LFREADONLY=false and are guarded by path fences and a two-step, parameter-bound confirmation flow. See the CHANGELOG for per-release notes and the roadmap for what's next.

Quick start

uv tool install laserfiche-mcp   # or run ad hoc: uvx laserfiche-mcp
laserfiche-mcp setup             # wizard: server URL + account, then verifies the connection
laserfiche-mcp ls 1              # you're in — list the repository root

Then wire it into your MCP client — see Claude Desktop and Claude Code below. Prefer environment variables over the wizard? See Configure. Want a no-terminal install instead? See the Claude Desktop extension.

What you can do with it

Once connected, Claude can:

Read (always available):

• Search the repository with native Laserfiche search syntax, by name pattern, or via the LLM-friendly search_natural flow (asks the server for templates first, then runs with automatic 400 repair)
• List the contents of any folder, look up an entry by ID or path, read all template field values, list field/tag/template/link definitions and audit reasons
• Inspect document metadata, fetch the raw edoc as base64, or extract text locally (PDF, DOCX, PPTX, XLSX, EML, HTML, RTF, text/) — all via getdocument_edoc(..., mode=...)

Write (opt-in via LFREADONLY=false):

• Create folders, import documents, copy entries (async), rename and move entries
• Set, merge, and clear fields, tags, and links on an entry
• Assign and remove templates — with optional client-side validation of repository-required fields before the API call
• Delete entries (folders cascade), edocs, and specific page ranges — all with a two-step preview→confirm-token flow, HMAC-signed and bound to operation + entry + the operation's own parameters, expiring after 5 minutes

Operate safely — every write checks the entry's path against LFWRITEPATHSALLOW / LFWRITEPATHSDENY, folder deletes refuse unless forcelargedelete=true when child count exceeds LFDELETEFOLDERMAXDESCENDANTS, and LFWRITETOOLS_ALLOWED can scope a deployment to e.g. metadata-only writes.

Install

Two ways to run it, depending on who you are.

For everyone — the Claude Desktop extension

Shortened. The full README is on GitHub.