
Connects Claude to DEVONthink 4 via AppleScript for search, filing, bulk operations, and similar-document lookup. Ships seven tools with a preview-then-apply pattern: all write operations run in dry-run mode first, return a confirm token, and log to an append-only SQLite audit with selective undo. Includes optional local RAG via ChromaDB and sentence-transformers for hybrid vector search. Installs as a drag-and-drop .mcpb bundle in Claude Desktop or via pipx for CLI use. Roadmap includes HTTP transport with OAuth 2.1 for remote access. MIT licensed, privacy-first design with all data and embeddings staying local. Built for anyone managing contracts, invoices, or research notes in DEVONthink who wants conversational access without risking accidental mutations.
ISTEFOX_FAST_LIST_DATABASESSet to '1' to skip recursive record_count when listing databases. Useful for databases with tens of thousands of records where the first call would otherwise take several seconds.
ISTEFOX_PREVIEW_TTL_SOverride TTL in seconds for preview_token returned by file_document/bulk_apply dry_run (default 300, range 1-3600).
ISTEFOX_RAG_ENABLEDSet to '1' to enable embedded ChromaDB vector retrieval for ask_database and search (mode=hybrid). EXPERIMENTAL in 0.1.0; embedding model not yet benchmarked cross-corpus (see ADR-008).
ISTEFOX_RAG_MODELsentence-transformers model name used by the RAG provider. Default paraphrase-multilingual-MiniLM-L12-v2 (~120MB). Override examples: BAAI/bge-m3 (~2.2GB).