LoreDocs

Export a complete manifest of a vault's contents. Returns vault metadata, document list with tags and categories, tag frequency index, category counts, and link count. Use the json format for machine-readable output. Use the markdown format for human-readable summaries.

Find all documents linked to a given document. Pro only. Returns each related document with its vault, category, tags, and link label. Use vault_link_doc to create new links.

Retrieve a document's metadata and optionally its text content. Use include_content=false to get just the metadata without loading the full text.

Return the stored per-vault injection token cap (or 'not set' if none). If not set, the server falls back to LOREDOCS_INJECTION_CAP_TOKENS env var, then LOREDOCS_INJECTION_DEFAULT_CAP_TOKENS (default 100000).

Return LoreDocs documents linked to a given LoreConvo session. Queries the LoreDocs cross_product_links table for links where the session is the source or target. Returns both auto and manual links. Requires Pro tier for auto-links. Args: session_id -- LoreConvo session UUID limit -- max results (default 5) Returns same structure as vault_get_session_links.

Return a summary of this LoreDocs server's injection capabilities and token estimation settings. Useful for diagnosing injection behavior or verifying which features are active.

Return cross-product LoreConvo sessions linked to a LoreDocs document. Both LoreConvo and LoreDocs must be installed. Requires Pro tier for auto-links. Manual links are always returned. Args: doc_id -- LoreDocs document ID limit -- max results (default 5) Returns dict with: schema_version -- CROSS_LINK_SCHEMA_VERSION for version negotiation cross_product_available -- bool tier_gate -- "satisfied" | "pro_required" links -- list of {target_product, target_id, similarity_score, link_type, created…

Generate a fresh session token (UUID4) for use with vault_inject / vault_prime. Pass the returned token as session_token in subsequent injection calls so the per-session cache can scope cached results to this conversation. Cache hits are valid until any document in the vault is updated.

Bulk import all supported files from a directory into a vault. Imports text files, PDFs, Word docs, Excel files, PowerPoints, and more. Each file becomes a separate document with text extracted for search indexing. Files over 30MB are skipped. Hidden files (starting with .) are skipped. Supports Obsidian vaults: subdirectories are traversed recursively by default (set recursive=False for single-level import). Markdown files with YAML frontmatter tags (tags: [a, b] or block-list style) have those tags merged into the document.

Import Notion pages and databases into a LoreDocs vault. Uses the import-once-and-own model: pages are fetched once and stored as LoreDocs documents. No live sync dependency. Token is read from the NOTION_TOKEN environment variable or OS keychain -- it is NEVER passed as a parameter, so it never appears in MCP tool-call logs. vault accepts a vault ID (stable across renames, preferred for automation) or a vault name (case-insensitive, for interactive use). page_ids and database_ids accept Notion UUIDs (32 hex chars without dashes or 36 chars with dashes). Both null/omitted = rejected (at le…

Report Notion import readiness and how to enable it. Read-only. Does not install or modify any packages.

Get detailed information about a vault, including its full document manifest. Accepts either a vault ID or vault name.

Load ranked vault documents into conversation context with token-budget enforcement. Documents are ranked by FTS5 relevance (when query is provided) and priority weight, then packed greedily until the effective token cap is reached. Args: vault_name: Vault name or ID. query: Optional FTS5 search query to rank documents by relevance. max_tokens: Hard token budget. Overrides vault DB cap. Effective cap = max_tokens * safety_factor. cap_behavior: 'best_effort' (inject as many docs as fit) or 'strict' (error if any doc exceeds cap). session_token: Optional opaque string used …

Load all documents matching any of the given tags into the current conversation context. Documents matching any of the provided tags are fetched, ranked by priority weight and recency, then packed greedily within the token cap. Args: vault_name: Vault name or ID. tags: List of tags to match (OR semantics: any matching tag includes the doc). max_tokens: Hard token budget. Effective cap = max_tokens * safety_factor. cap_behavior: 'best_effort' (inject as many docs as fit) or 'strict'. session_token: Optional opaque string used as per-session cache key. max_single_doc_to…

Generate a summary overview of a vault's contents for conversation orientation. Lists all documents with their categories, tags, priorities, and notes. Useful at the start of a conversation to understand what knowledge is available.

Create a link between two documents across any vault. Links are bidirectional and labelled (e.g. 'related', 'references', 'supersedes', 'part-of'). If the link already exists, reports it. Use vault_find_related to discover all docs linked to a given document.

Associate a Claude Project name with a vault. This is metadata for your organization -- it records which Claude Projects use knowledge from this vault. A vault can be linked to multiple projects.

Create a manual cross-product link from a LoreConvo session to a LoreDocs doc. Both LoreConvo and LoreDocs must be installed. Manual links are accessible on all tiers. The linked doc must not be in an opt-out vault. Args: session_id -- LoreConvo session UUID doc_id -- LoreDocs document ID vault_id -- LoreDocs vault containing the document Returns dict with: ok -- bool session_id, doc_id on success reason -- failure description (generic; details in debug log)

List all knowledge vaults with summary stats (document count, total size, last modified). Use this to see what vaults exist and find the one you need.

List documents in a vault with sorting and filtering options. Supports sorting by name, date, size, or category. Filter by category or tag to narrow results.

Move a document to a different vault. Removes it from the source vault.

Open (or create) a vault scoped to a workspace directory. If a vault is already linked to this directory path, returns it. Otherwise, creates a new vault named after the directory and records the workspace_path so future calls return the same vault. This mirrors how MemClaw scopes memory to workspaces -- lower friction than naming vaults manually. Named vaults remain available for users who prefer explicit management.

Pre-load all vault documents into the current session by priority order. Equivalent to vault_inject with no query: loads all documents ordered by priority weight (authoritative first), then by recency. Use at session start to orient yourself on all knowledge available in a vault. Args: vault_name: Vault name or ID. max_tokens: Hard token budget. Effective cap = max_tokens * safety_factor. cap_behavior: 'best_effort' (inject as many docs as fit) or 'strict' (error if cap exceeded). session_token: Optional opaque string used as per-session cache key. max_single_doc_tokens: …

Rebuild the LanceDB semantic search index from all stored documents. Pro only. Run this after first installing the Pro deps (pip install loredocs[pro]) or after restoring from backup. The index is kept in sync automatically for new documents added after install, but existing documents require a one-time rebuild to become searchable semantically.

Soft-delete a document. The document is hidden but can be recovered. For permanent deletion, use vault_delete to remove the entire vault.

Full-text or semantic search across document contents. Default (semantic=False): SQLite FTS5 keyword search. Supports FTS5 syntax: - Simple words: depreciation schedule - Phrases: "rental income" - Boolean: depreciation AND schedule - Negation: rental NOT commercial - Prefix: deprec* Semantic (semantic=True, Pro only): hybrid vector + BM25 search via LanceDB. Finds documents by meaning even when exact keywords differ. Requires LoreDocs Pro and `pip install loredocs[pro]`. Falls back to FTS5 if the semantic index has not been built yet (run vault_rebuild_index first).

Find all documents with a specific tag, across one vault or all vaults.

Set the per-vault injection token cap (admin-only). Requires LOREDOCS_ENABLE_CAP_TOOLS=1 and a valid LOREDOCS_ADMIN_TOKEN. Once set, all vault_inject / vault_prime / vault_inject_by_tag calls for this vault use this cap unless the caller overrides with max_tokens. Args: vault_name: Vault name or ID. max_tokens: Token cap to store (must be >= 100). admin_token: Value of LOREDOCS_ADMIN_TOKEN (never logged or echoed).

Mark a document's priority/status: authoritative, normal, draft, or outdated. 'authoritative' means this document is the source of truth. 'outdated' flags the document as no longer current.

Activate a tier (free or pro) for LoreDocs. Pro tier removes all vault, document, storage, and version limits. After purchasing a Pro license, set LOREDOCS_PRO=<your-license-key> in your environment and restart the server, then call this tool with tier='pro' to persist the Pro tier. Reverting to tier='free' re-enables limits (but does not delete any existing data that exceeds the limits -- it only blocks new writes).

Get suggestions for documents that may need attention. Surfaces documents that are undocumented (no notes), unorganized (no tags), or isolated (no links to other documents). Use to guide housekeeping work or to discover documents that haven't been connected to the broader graph. Optionally scope to a single vault.

Add or remove tags on a document. You can add and remove tags in a single operation. Tags are case-sensitive strings. Duplicates are automatically removed.

Show current tier (Free or Pro) and usage vs. limits. Displays how many vaults and how much storage are in use, with percentages against Free tier limits. Useful before hitting a limit to know how close you are, or to confirm Pro tier is active after upgrading.

Remove a link between two documents (both directions). If no link exists between the two documents, reports that cleanly.

Update a document's content or metadata. If content changes, the previous version is saved automatically in the version history. You can restore old versions with vault_doc_restore. The author, session_id, and note params are stored in the version's metadata sidecar for provenance tracking. Unknown parameters are rejected at the MCP dispatch layer (see _forbid_unknown_tool_params below): FastMCP's generated arg model for this tool has extra="forbid", so a client-supplied unknown param never reaches this function body.

Verify version-storage integrity for a vault or specific document. By default, runs a read-only check that reports: - Stale intent journals (crash recovery left incomplete) - Recovery orphan files - Missing, invalid, or too-new version sidecars - Missing versions (no content file and no rotation record) - Version count disagreement between DB and filesystem - History divergence (loss, jump, rollback, or holes) - Unrecognized files under history/ - Conflict files from hash-guarded replay - Per-vault history bytes vs the hard cap - Permissions advisory on the vault root With repair=True, perfo…