librarian

librarian is a skill for Claude Code, Codex from ngmeyer/librarian-mcp. It costs 35 tokens per session (6,481 once invoked), scanned B, original, MIT.

A workflow tool for managing a knowledge vault through a Librarian server. It can store solutions, search previous work, connect related notes, and record learnings.

In plain words
What is it for?
Use it to import files, web pages, emails, calendar notes, or coding sessions; search the vault; add daily learnings; and find related notes.
Why use it?
It helps developers find and preserve useful project knowledge instead of losing solutions in separate documents or past conversations.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/ngmeyer/librarian-mcp/skill
Any agent
npx skills add ngmeyer/librarian-mcp --skill skill
Clone the repo
git clone --depth 1 https://github.com/ngmeyer/librarian-mcp

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for librarian

README.md
[![agentmods](https://agentmods.dev/badge/skills/ngmeyer/librarian-mcp/skill.svg)](https://agentmods.dev/skills/ngmeyer/librarian-mcp/skill)
Your own site
<a href="https://agentmods.dev/skills/ngmeyer/librarian-mcp/skill"><img src="https://agentmods.dev/badge/skills/ngmeyer/librarian-mcp/skill.svg" alt="Measured on agentmods" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,481 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00035 $0.06481
Opus 5 $0.00017 $0.03240
Sonnet 5 $0.00007 $0.01296
Haiku 4.5 $0.00003 $0.00648

Measured 4d ago against content hash 0f4aa4344106, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

librarian scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

- If `[session]` is a project name or path fragment, find matching project directory under `~/.claude/projects/`
skill/SKILL.md · 767 lines

How it starts

The opening of the file, as written. The whole thing — 767 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/librarian

Orchestrate high-level knowledge workflows using Librarian MCP tools.

Prerequisites

Librarian MCP server must be configured and running. Verify by checking that library_stats responds. If it fails, tell the user to run librarian-mcp --setup /path/to/vault and restart Claude.

Commands

/librarian ingest [path]           Ingest a solution doc into the vault
/librarian import <file>           Convert local document (PDF, DOCX, image) to vault markdown
/librarian from gmail <query>      Import Gmail threads matching a search into the vault
/librarian from web <url>          Import any web page into the vault as markdown
/librarian from twitter <url>      Import an X/Twitter thread into the vault
/librarian from calendar [query]   Import calendar events/meeting notes into the vault
/librarian from claude [session]   Extract learnings from a Claude Code session into the vault
/librarian search <query>          Deep search vault for prior art
/librarian connect [path]          Find and apply missing wikilinks
/librarian daily [text]            Append a learning to today's daily note
/librarian graph [note]            Explore vault structure or a note's neighborhood
/librarian analyze                 Full vault analysis: god nodes, communities, viz, report
/librarian daydream [focus]        Discover non-obvious connections across vault notes
/librarian status                  Vault health overview

If no command is given, show the usage summary above.


ingest

Purpose: Import a docs/solutions/ file (or any local markdown) into the vault, gaining auto-wikilinks and knowledge graph integration. This is the bridge between per-project documentation (like ce:compound output) and the persistent vault.

Behavior

  1. Locate the source file:
    • If [path] is provided, use it directly
    • If no path, scan docs/solutions/ for the most recently modified .md file
    • If docs/solutions/ doesn't exist or is empty, tell the user and stop

Read the full file on GitHub · 767 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 767 lines · 35 tokens per session scan B 0f4aa4344106

Subscribe to this mod's changes

librarian is a skill published in the GitHub repository ngmeyer/librarian-mcp (29 stars, last pushed 2mo ago), licensed MIT. It adds 35 tokens to every session and 6,481 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

save

File the current Claude conversation (or a specific insight from it) as a structured wiki note. Auto-detects the right type (decision, answer, session-log, technique, ADR), writes appropriate frontmatter, places the file in the correct wiki folder, and updates catalog.md, journal.md, hot.md. Use when the user says…

tboome33/obsidian-mcp-router · 112 tokens

who-is-speaking

Identify the family member speaking in a shared family vault (e.g., vaulttribu), then lock the router to that vault + set auto-enrich mode to Hybrid so subsequent auto-saves route to wiki/People/ /. Companion skill for the tribu-routing convention. Trigger this skill at the start of any session on a shared…

tboome33/obsidian-mcp-router · 237 tokens

wiki-export

Export a vault's wiki either as a single portable file (llms.txt or llms-full.txt per the llmstxt.org standard) or as an OKF knowledge bundle (Google's Open Knowledge Format v0.1 — a shareable directory of markdown files any AI agent can consume). Use when the user says "export my wiki", "make an llms.txt", "share my…

tboome33/obsidian-mcp-router · 129 tokens

wiki-fold

Roll up the wiki's journal.md entries into structured fold pages — like 2^k log compaction. Reads the last 2, 4, 8, 16... entries and writes a fold page that summarizes them by extractive summarization (no invention), with backlinks to children. Idempotent at the structural level — re-running with the same window…

tboome33/obsidian-mcp-router · 125 tokens

wiki-graph

Build a typed knowledge graph (Understand-Anything-compatible JSON) from a vault's wiki — articles, entities, claims, sources, topics, and their relationships — so it can be visualised in an interactive graph dashboard. Use when the user says "build the knowledge graph", "graph my vault", "make a…

tboome33/obsidian-mcp-router · 121 tokens

wiki-ingest

Read a source (file, URL, or pasted text), extract the entities and concepts that matter, and file them as wiki pages with cross-references. Updates the wiki's catalog.md, journal.md, and hot.md so future sessions can find what was ingested. Use this skill whenever the user says "ingest this", "add this to the wiki"…

tboome33/obsidian-mcp-router · 121 tokens