PMB AI MCP server
io.github.oleksiijko/pmb-ai·v1.1.0·280 starsLocal-first persistent memory for AI coding agents.
280 stars131 downloads/wk
Reviews
Write oneNobody has reviewed PMB AI yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
PMB AI tools (69, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
apply_daily_decayApply forgetting curve to all events.
arc_detailGet full detail of one arc: title, summary, member events.
auto_resolve_conflictsAuto-archive obvious 'supersede' conflicts.
chain_currentLatest milestone of a chain - the 'current state'. Use to answer 'how many X do we have now?' / 'what's the latest?'.
chain_historyFull chronological history of a state-chain. Reconstructs the evolution: state_1 → state_2 → ... → state_N with the reason at each step.
clear_predictive_cacheClear all entries from the predictive cache.
cluster_into_arcsPMB v2 Phase 3: LLM groups events into narrative arcs (story threads). Arcs help recall on 'tell me about X' style queries.
cold_statsGet info about cold storage (archived events database).
compact_storageCompact storage: move old archived events to cold storage and VACUUM.
consolidate_recentdedupe_list_pendingList borderline duplicate pairs awaiting verdict (L2.5). These are pairs that scored cosine 0.80-0.92 - too risky to auto-merge, but worth review.
dedupe_run_pendingwrite actionDrain the borderline pair queue via LLM verify. backend: 'auto' (try Ollama then Anthropic) | 'ollama' | 'anthropic'
dedupe_sweepImprovement U: one-shot dedup over all active events.
dedupe_undoRestore events archived by previous dedup runs. Reversible.
detect_conflictsFind conflicting facts between different timestamps.
extract_factsImprovement D (mem0-style): LLM extracts atomic facts from recent events. Each fact becomes a new searchable event.
feedback_summaryAggregate user recall feedback. Returns useful_rate and top flagged-wrong events. This is the real-user health metric.
file_correlationsFind files that are often modified together with the given file.
file_historyGet commit history for a specific file.
find_lessonsPull procedural lessons (project rules / gotchas) relevant to a topic. Use this BEFORE making a project-shaping choice - picking a library, setting up tooling, choosing an approach - to see what worked or failed before.
forgetArchive a memory. Not deleted, can be restored.
get_subfactsReturn all subfacts linked to a parent event (Improvement P).
graph_neighborsCo-occurrence neighbors of an entity. Useful for 'what relates to X'.
graph_statsCounts of entities and edges in this workspace's association graph.
graph_top_entitiesMost-mentioned entities. kind = 'file' | 'tech' | 'concept' or None.
health_trendGet trend of self-test accuracy over time.
index_pdf📄 Extract text from a PDF and persist it as searchable memory.
index_project📂 Index a code project's structure - per-file symbols, imports, languages - so the agent can recall things like "where is the auth flow", "which files import LanceDB", "show me the recall pipeline".
lesson_impact📊 Earned Memory: which lessons actually HELP outcomes (not just which were read or followed). Joins each surfaced lesson to the OUTCOME of the turn it was active in - tests pass/fail, red->green, build, deploy (no LLM) - and returns per-lesson success_rate, lift vs the no-lesson baseline, and churn. Use to spot dead-weight or HARMFUL rules (negative lift). Worst lift first.
list_arcsList narrative arcs in the current workspace.
list_goalsList goals (optionally filter by status).
list_recentList the most recent active events in the workspace.
mark_lesson_followedConfirm whether a previously surfaced lesson actually changed your behaviour on the current task. Call this AFTER acting on a lesson - the self-improvement loop uses this signal to identify useful vs dead lessons.
overviewGet a structured OVERVIEW of everything memory knows about a topic.
pinPin a memory: max importance, never auto-archived.
precompute_predictive_cacheImprovement F (PMB-unique): during sleep, LLM predicts likely questions and pre-runs recall. Future near-identical queries get instant (~3ms) responses via cosine match.
prepare⭐⭐⭐ Call this ONCE at the START of any substantive user task.
project_overview⭐ Use at the START of any project work - returns the FULL project context in ONE call, sourced from the entity graph (not recall):
project_structure🗺️ Pull a project's STRUCTURE straight from memory - no filesystem scan.
recallSearch PMB long-term memory. CALL THIS FIRST when user asks about: - past decisions (why did we choose X, what port did we set) - project history (when did we, what happened with) - people (who is X, what did Alice say) - any fact the user might have recorded earlier
recall_deepDEEP recall - explicitly opt into the slow, thorough path.
recall_exploration💡 BEFORE re-exploring the codebase, check if a PAST session already figured this out. Returns memoized conclusions matching `intent`, each with a freshness check: • `fresh: true` -> every source file is unchanged, trust the conclusion and skip the re-reading entirely. • `fresh: false` -> `stale_files` lists what changed since; re-check ONLY those, reuse the rest.
recall_smartAuto-escalating recall, but FAST and deadline-bounded. Starts with a normal local recall; if confidence is low it escalates only with cheap local steps (wider pool + a local rerank when that model is already warm). It NEVER blocks on an LLM / Claude CLI on this path and always returns within `recall.smart_deadline_ms` (default 15s), returning the best result found so far if the budget is hit.
recent_activityImprovement Q: working memory dump - instant, no search.
record_activityImprovement Q: log a working-memory activity.
record_batchrecord_codeRecord code content. For Python, AST entities (functions, classes, imports) are auto-extracted into the graph layer (Improvement J).
record_exploration💡 AFTER researching something in the codebase (reading/grepping several files to reach a conclusion), memoize it so a FUTURE session can reuse the conclusion instead of re-deriving it.
record_factSTORE a fact for long-term recall. CALL THIS PROACTIVELY whenever the user mentions:
record_fact_treeImprovement P: store a main fact + multiple linked sub-facts in ONE call.
record_goalImprovement R: create a goal/intent (12-th semantic layer).
record_imageRecord an image (screenshot/diagram) in memory (Improvement J).
record_keyed_fact⭐ Use for SINGULAR personal attributes that CHANGE over time.
record_milestoneImprovement R: record a milestone in a named state-chain.
record_recall_feedbackRecord real recall feedback for an event.
reflect_batchPMB v2 sleep operation: LLM reflects on recent un-reflected events.
rememberStore a Q/A interaction in memory.
run_self_testwrite actionQuantify memory health: system asks itself questions from old memories.
search_images_by_textCross-modal image search. Encodes the query via CLIP text encoder and finds nearest stored image embeddings.
session_briefRe-orient in a long session: a digest of what was decided / done / learned so far THIS session.
session_currentGet current active session info (or None).
session_endEnd the current session. Returns the closed session's info.
session_startStart a new memory session. Used to group related events.
session_timelineChronological dump of CURRENT session events. Use for post-mortem 'summarize this session' style questions.
statsGet workspace and memory statistics.
sync_gitCapture recent git commits into memory.
update_goalwrite actionUpdate goal status / progress. Creates a goal_update event so the full history of changes is preserved.
what_just_happenedQuick: last N events of any type from current session. Use to answer 'what were we doing?' / 'recap of this session'. Instant, no search.
workspace_infoIdentify the current PMB workspace.
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan172 source files scanned8/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 qualitylocal package, no credentials required12/15
- Maintenancelast push 3 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (2)
- highShell command built from a string (injection risk)
exec.shell-concatpmb_ai-1.1.0/src/pmb/cli/commands/config.py: …ad" if os.name == "nt" else "nano") os.system(f'{editor} "{path}"') … - mediumeval / new Function used
exec.evalpmb_ai-1.1.0/src/pmb/config.py: …fault - and a real-workspace " "eval (June 8 2026) with the default MiniLM emb…
How PMB AI compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 66/100
- higher than 23% of 48,255 servers
- Tools
- 69
- the typical server has 7
- Tools that change things
- 4%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 280
- more than 95% of 28,688 servers
- Downloads a week
- 131
- more than 68% of 12,191 servers with a package
What its tools let an agent do: 63 read · 4 change · 2 run or deploy
Install PMB AI in Claude Code, Cursor or VS Code
claude mcp add pmb-ai -- uvx pmb-ai
What the publisher says
From the PMB AI repository's README, as published. We do not edit it. Read it on GitHub
<!-- mcp-name: io.github.oleksiijko/pmb-ai -->
PMB
Local-first memory for your AI coding agent.
SQLite is the source of truth. No cloud, no API keys, no re-explaining.
Local-first memory, visualized. 3,800+ entities and 41,000+ connections, captured automatically as you work.
Website · Docs · Quickstart · Demo · Why PMB · How it works · FAQ
Your AI agent forgets everything between sessions. So you re-explain the same decisions, lessons and constraints over and over. PMB remembers them in one local workspace and feeds them back through MCP - no cloud, no API keys, no LLM call on the read path. And it tells you when memory is actually helping, instead of claiming "+X%".
⭐ Star the repo if PMB saves you a re-explanation.
PMB gives Claude Code, Cursor, Codex and the other MCP-aware agents a real memory: decisions you made last week, lessons you taught them, personal facts, project structure, PDFs. They survive every restart, every model upgrade, every agent switch - because they live in a local workspace you own, with SQLite as the durable source of truth and rebuildable search indexes beside it.
No API keys. No subscription. No LLM call on the read path. Just local files.
Quickstart
pip install pmb-ai # 1. install
pmb setup # 2. detect your agent + wire the MCP entry
pmb warmup # 3. preload the model (first recall is instant)
# 4. restart your agent, then just talk to it - memory is automatic
pmb stats # 5. see what's stored
pmb recall "auth decision" # 6. search memory from the terminal
pmb doctor # 7. confirm everything is wiredThat's it - your agent now remembers. No account, no keys, nothing leaves your machine.
Command name: the CLI is pmb. Via pip you also get the alias
pmb-ai; via npm (npx pmb-ai setup) the command is pmb-ai and it
installs the Python package first, then runs setup. Same tool - use whichever
your install gave you.
Links: pmbai.dev (site) ·
docs.pmbai.dev (docs) ·
Getting started ·
Deleting memories.
Demo
What it feels like - same prompt, with and without memory:
▶ Click to play the 2-minute setup
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
PMB AI: common questions
- Is PMB AI MCP server safe?
- With care: it is graded C, so read the findings first (66/100). Read the PMB AI safety report
- How do I install PMB AI?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does PMB AI need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is PMB AI maintained?
- The last commit was 42 days ago (2026-09-23). The latest release is v1.1.0.
- What can I use instead of PMB AI?
- Servers from other publishers that do the same job: Deja Vu MCP server, Memorix MCP server and Nautilus Compass Memory MCP server.
- How does PMB AI compare with other MCP servers?
- safety score 66/100 (higher than 23% of 48,255 servers); tools 69 (the typical server has 7); tools that change things 4% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to PMB AI
Same job from other publishers: the closest match first, then the best rated.
- Deja Vudeja-vu: local memory over the session histories of forty-three coding agents.not reviewedEstablishedA
MemorixLocal-first project memory with legacy MCP and 2026 discovery compatibility.not reviewedEstablishedB- Nautilus Compass MemoryLocal-first long-term memory for AI agents, with byte-recomputable signed verification receipts.not reviewedEstablishedB
State Memory MCPPersistent workflow graph server tracking tasks, decisions, spatial entities, and blockers.not reviewedEstablishedA
KnowlPersistent memory for AI agents, for code, research and everyday life. Stale facts retire.not reviewedEstablishedA