briefLABSCO SUMMARY
Offline semantic search first, marketplace second.
The part that works with no account and no network is the part that matters day to day: an embedding model on disk, a library you own, and ranking that rewards entries you keep finding useful. The Telvok library and bounties sit above that as an opt-in layer, which means you can adopt the capture habit without buying into the marketplace. The API reference is marked beta by the author.
What it is
A knowledge-management MCP server for AI coding assistants. You record insights as you hit them, and search them later by meaning rather than by wording — saving "Stripe webhooks need idempotency checks" and later searching "handling duplicate payment events" finds it. On top of your local library sits the Telvok library, where entries can be packaged as books, published, and downloaded.
What you get
- Semantic search over your own library and the capture path that fills it —
briefto search before deciding something,recordto keep what you learned,mark_hitto mark an entry as helpful and raise its ranking - Search that runs entirely offline: the
all-MiniLM-L6-v2model, 384-dim embeddings, roughly a 30MB download on first run and cached locally, with results ranked by semantic similarity plus recency (60%) and hit count (40%) - Import from the memory stores you already have —
import_memoriesreadsjsonl(Anthropic MCP Memory, mcp-knowledge-graph),markdown(Obsidian, Basic Memory MCP),cursor(Cursor Memory Bank),jsonandsqlite(mcp-memory-service, SQLite-vec) - Library tools for shared knowledge:
library_search,library_downloadfor free books,library_publishto package your own entries,my_books,syncto check owned books for updates,rate_bookandseller_analytics - A bounty system for knowledge you want but do not have —
bounty_create,bounty_list,bounty_claim,bounty_submit,my_bounties - Maintenance and account tools:
adoptto copy an imported entry into your local library,delete,rebuild_index,auth,helpandfeedback
Requirements
Nothing for local use — search and capture are fully offline with no API calls. Install with claude mcp add librarian -- npx @telvok/librarian-mcp, or point any MCP client at npx @telvok/librarian-mcp; Claude Code also has a plugin install that adds slash commands and hooks on top of the MCP tools. An account is only needed to reach the Telvok library: run auth({ action: "login" }), enter the returned code at telvok.com/device, then auth({ action: "complete" }) — the key is stored in .librarian/.auth and expires after 90 days. The library folder holds your entries, downloaded books, purchased content, the archive and the cached embedding model. MIT licensed.
Setup effort
One command — npm install -g @telvok/librarian-mcp
USE CASES
Checking whether you have solved this before
Search your library by meaning before making a decision, so a wording you no longer remember does not hide the note you wrote last quarter.
Keeping a hard-won detail
Record the insight with its context the moment you hit it, rather than trusting it to survive the session.
Bringing memories over from another tool
Import an existing store — Obsidian markdown, a Cursor memory bank, a JSONL export — and adopt the entries worth keeping into your local library.
Pulling in someone else's notes on a stack you are new to
Search the shared library and download a free book locally so it joins your own semantic search.
22 tools
Listed in project docs. Your client may show a different list.
recordadoptmark_hitimport_memoriesrebuild_indexdeletelibrary_searchlibrary_downloadlibrary_publishmy_bookssyncrate_bookseller_analyticsbounty_createbounty_listbounty_claimbounty_submitmy_bountiesauthhelpfeedbackBEFORE YOU INSTALL
What to know first
Tools you get
22 tools named in the project's documentation.
Requires
npx on PATH
INSTALLATION
Connect your client
Server setup
npm install -g @telvok/librarian-mcpMCP Clients
Claude Code — plugin
In Claude Code, run both commands:
/plugin marketplace add telvokdev/librarian
/plugin install librarian@librarianClaude Code — npx
claude mcp add librarian -- npx @telvok/librarian-mcpCursor, Windsurf, Any MCP client
{
"mcpServers": {
"librarian": {
"command": "npx",
"args": [
"@telvok/librarian-mcp"
]
}
}
}