LoreDocs MCP server
Local-first knowledge vaults for project docs and specs. Tagged, versioned, full-text searchable.
4 stars41 downloads/wk
Reviews
Write oneNobody has reviewed LoreDocs yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
LoreDocs tools (51, 7 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
get_license_tierReturn the current LoreDocs license tier and status.
get_server_infoReturn MCP compatibility status for this LoreDocs server.
loredocs_onboardSet up or update your LoreDocs workspace configuration.
vault_add_docAdd a text document to a vault with metadata (tags, category, priority, notes).
vault_add_noteAttach a contextual note to a document.
vault_archiveArchive a vault (soft delete). Archived vaults are hidden from vault_list by default but can be restored.
vault_bulk_tagApply tag changes to multiple documents at once.
vault_categorizeSet a document's category (general, reference, config, report, template, archive, imported).
vault_copy_docCopy a document from one vault to another, including all metadata.
vault_createwrite actionCreate a new knowledge vault for organizing project documents.
vault_deletewrite actionPermanently delete a vault and ALL its documents. This cannot be undone.
vault_doc_historyView the version history for a document.
vault_doc_restoreRestore a document to a previous version.
vault_estimate_tokensPreview the token count of a vault injection without injecting documents.
vault_exportExport all documents from a vault to a local directory.
vault_export_manifestExport a complete manifest of a vault's contents.
vault_find_relatedFind all documents linked to a given document. Pro only.
vault_get_docRetrieve a document's metadata and optionally its text content.
vault_get_injection_capReturn the stored per-vault injection token cap (or 'not set' if none).
vault_get_linked_sessionsReturn LoreDocs documents linked to a given LoreConvo session.
vault_get_server_capabilitiesReturn a summary of this LoreDocs server's injection capabilities and token estimation settings.
vault_get_session_linksReturn cross-product LoreConvo sessions linked to a LoreDocs document.
vault_get_session_tokenGenerate a fresh session token (UUID4) for use with vault_inject / vault_prime.
vault_import_dirBulk import all supported files from a directory into a vault.
vault_import_notionImport Notion pages and databases into a LoreDocs vault.
vault_import_notion_setupReport Notion import readiness and how to enable it. Read-only. Does not install or modify any packages.
vault_infoGet detailed information about a vault, including its full document manifest.
vault_injectLoad ranked vault documents into conversation context with token-budget enforcement.
vault_inject_by_tagLoad all documents matching any of the given tags into the current conversation context.
vault_inject_summaryGenerate a summary overview of a vault's contents for conversation orientation.
vault_link_docwrite actionCreate a link between two documents across any vault.
vault_link_projectAssociate a Claude Project name with a vault.
vault_link_sessionwrite actionCreate a manual cross-product link from a LoreConvo session to a LoreDocs doc.
vault_listList all knowledge vaults with summary stats (document count, total size, last modified).
vault_list_docsList documents in a vault with sorting and filtering options.
vault_move_docMove a document to a different vault. Removes it from the source vault.
vault_open_workspaceOpen (or create) a vault scoped to a workspace directory.
vault_primePre-load all vault documents into the current session by priority order.
vault_rebuild_indexRebuild the LanceDB semantic search index from all stored documents. Pro only.
vault_remove_docwrite actionSoft-delete a document. The document is hidden but can be recovered.
vault_searchFull-text or semantic search across document contents.
vault_search_by_tagFind all documents with a specific tag, across one vault or all vaults.
vault_set_injection_capSet the per-vault injection token cap (admin-only).
vault_set_priorityMark a document's priority/status: authoritative, normal, draft, or outdated.
vault_set_tierActivate a tier (free or pro) for LoreDocs.
vault_suggestGet suggestions for documents that may need attention.
vault_tag_docAdd or remove tags on a document.
vault_tier_statusShow current tier (Free or Pro) and usage vs. limits.
vault_unlink_docwrite actionRemove a link between two documents (both directions).
vault_update_docwrite actionUpdate a document's content or metadata.
vault_verifyVerify version-storage integrity for a vault or specific document.
Public scan report
scanner v0.1.9 · 2026-09-25 · same rubric, same numbers if you re-run it
- Code scan17 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
What the publisher says
From the LoreDocs repository's README, as published. We do not edit it. Read it on GitHub
LoreDocs v0.1.28
Your AI project's knowledge base. Organized, searchable, version-tracked.
LoreDocs gives Claude persistent access to your project documentation -- specs, guides, architecture decisions, reference docs -- so it never loses context between sessions. Works with Claude Code, Cowork, Cursor, OpenAI Codex, and Hermes Agent.
Install directly from Claude Code's plugin marketplace, or via PyPI: uvx loredocs
Quick Start
Prerequisites: uv (fast Python package manager).
# Install uv (one time)
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone and install
cd /path/to/loredocs
uv syncFor detailed installation instructions, see INSTALL.md.
Using the Claude Agent SDK directly? git clone the public repo and point the SDK's local-directory plugin loader at it -- the repo root is a self-contained plugin directory (.claude-plugin/plugin.json + .mcp.json). No separate SDK-installable bundle exists or is needed.
Using LoreDocs
Claude Code (Terminal)
claude --plugin-dir /path/to/loredocsOr inside an existing session:
/plugin add /path/to/loredocsOnce loaded, Claude has access to all 48 LoreDocs MCP tools automatically. Ask Claude to "create a vault for this project" or "find the architecture doc" and it uses the tools on its own.
Cowork (Desktop App)
- Click + next to the prompt box
- Select Plugins > Add plugin
- Browse to the loredocs source folder
Shared Database Access: Cowork runs in a sandboxed VM. To access docs saved from Claude Code, ask Claude:
"Mount my ~/.loredocs folder"
How It Works
LoreDocs organizes knowledge into vaults -- named containers for related documents. Each vault can hold specs, guides, decisions, checklists, or any text you want Claude to remember.
~/.loredocs/loredocs.db <-- SQLite database (metadata, search index)
~/.loredocs/vaults/<vault-id>/ <-- Document files on diskKey concepts:
- Vaults group related docs by project or topic
- Documents are text files with metadata (tags, categories, priority, notes)
- Version history tracks every change to every document
- Full-text search via SQLite FTS5 finds anything instantly
- Injection loads vault content into Claude's context on demand
Your Data is Always Available
LoreDocs works through MCP tools when they are available and falls back to bundled scripts automatically when they are not. Your vault documents are safe regardless of MCP status -- the same add, search, and retrieve operations work either way. You do not need to configure anything; the plugin skill handles the switch silently.
Verify Installation
After installing, verify LoreDocs is working by asking Claude:
"Run vault_list and show me the results."
If you see a list of vaults (or an empty list if this is your first time), LoreDocs is connected. If you get an error about missing tools, re-run uv sync and reload the plugin.
Recommended CLAUDE.md Setup
For the best experience, add the following snippet to your ~/.claude/CLAUDE.md (global) or your project's CLAUDE.md. This tells Claude how to use LoreDocs consistently across sessions.
## LoreDocs (persistent project knowledge)
At session start:
1. Call `vault_list` to see available knowledge vaults.
2. Call `vault_inject_summary` for any vaults relevant to the current project.
3. Use this context to understand project architecture, decisions, and reference docs.
During the session:
- If you create significant documentation, add it to LoreDocs with `vault_add_doc`.
- Tag documents for easy cross-vault discovery with `vault_tag_doc`.
At session end:
- If new docs were created or updated, ensure they are stored in LoreDocs for future sessions.Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add loredocs -- uvx loredocs
LoreDocs: common questions
- Is LoreDocs MCP server safe?
- Mostly: it is graded B (80/100). Read the LoreDocs safety report
- How do I install LoreDocs?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does LoreDocs need an API key?
- Yes. The registry entry asks for
LOREDOCS_PRO. - Is LoreDocs maintained?
- The last commit was in the last day (2026-09-25). The latest release is v0.1.28.
- What can I use instead of LoreDocs?
- Servers from other publishers that do the same job: MCP server, Obsidian Hybrid Search MCP server and loci MCP server. Compare all LoreDocs alternatives.
Alternatives to LoreDocs
Same job from other publishers: the closest match first, then the best rated.
- MCPManage Appwrite projects, databases, auth, storage, functions, and messaging; search Appwrite docsnot reviewedEstablishedA
- Obsidian Hybrid SearchSearch Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval.not reviewedEstablishedB
- lociCross-session memory and hybrid RAG over your notes and docs. Local-first, with cited answers.not reviewedEstablishedA
- OrchestKit Docs MCPRead-only MCP server for the OrchestKit docs: full-text search + Markdown fetch. No auth.not reviewedEstablishedA
AI ContextLocal-first MCP server: version-correct library docs, code map, and offline drift for your repo.not reviewedGrowingB