About Moltbrain
Moltbrain is an MCP server published by nhevers in the Developer Tools category: long-term memory layer for OpenClaw & MoltBook agents that learns and recalls your project context automatically. It has been installed 0 times through Conduid.
The repository has 358 stars and 40 forks, with the last commit 6 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues (0) before depending on it in production.
Install
Install
npx moltbrainThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about Moltbrain
Powered by Claude · Grounded in docs
I know everything about Moltbrain. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
⚡ Quick Install
╔══════════════════════════════════════════════════════════════════════╗
║ ║
║ Step 1 /plugin marketplace add nhevers/moltbrain ║
║ Step 2 /plugin install moltbrain ║
║ ║
╚══════════════════════════════════════════════════════════════════════╝
🧠 What It Does
╭──────────────────────────────────────────────────────────────────────────────╮
│ │
│ ┌─────────────────┐ ┌─────────────────┐ │
│ │ SESSION #1 │ │ SESSION #47 │ │
│ │─────────────────│ │─────────────────│ │
│ │ │ │ │ │
│ │ "Set up auth │ │ "Add password │ │
│ │ with OAuth" │ │ reset flow" │ │
│ │ │ │ │ │
│ └────────┬────────┘ └────────┬────────┘ │
│ │ │ │
│ │ Claude discovers: │ Claude remembers: │
│ │ • OAuth2 + PKCE flow │ • Your auth setup │
│ │ • JWT with 1hr expiry │ • Token structure │
│ │ • bcrypt cost factor 12 │ • Security choices │
│ │ │ │
│ ▼ ▲ │
│ ┌────────────────┐ ┌────────────────┐ │
│ │ CAPTURE │ ──────────────────► │ INJECT │ │
│ │ & LEARN │ MEMORY │ & RECALL │ │
│ └────────────────┘ └────────────────┘ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
✨ Features
+-------------------------+-------------------------+-------------------------+
| | | |
| OBSERVATIONS | SMART SEARCH | WEB VIEWER |
| ---------------- | ---------------- | ---------------- |
| Auto-captures | Semantic search | Browse history |
| discoveries, | via MCP tools | at localhost |
| decisions & code | finds context | :37777 |
| | | |
+-------------------------+-------------------------+-------------------------+
| | | |
| ANALYTICS | TAGS & FILTERS | FAVORITES |
| ---------------- | ---------------- | ---------------- |
| Track tokens, | Organize with | Bookmark your |
| sessions, and | custom tags & | most important |
| concept trends | smart filters | observations |
| | | |
+-------------------------+-------------------------+-------------------------+
| | | |
| EXPORT | THEMES | SHORTCUTS |
| ---------------- | ---------------- | ---------------- |
| JSON, CSV, or | Dark & light | Full keyboard |
| Markdown with | mode with | navigation in |
| custom templates | custom themes | the web viewer |
| | | |
+-------------------------+-------------------------+-------------------------+
🔧 How It Works
╔═══════════════════════════════════╗
║ CLAUDE CODE SESSION ║
╚═══════════════╤═══════════════════╝
│
┌────────────────────┼────────────────────┐
│ │ │
▼ ▼ ▼
╔════════════════╗ ╔════════════════╗ ╔════════════════╗
║ SessionStart ║ ║ PostToolUse ║ ║ Stop ║
║────────────────║ ║────────────────║ ║────────────────║
║ Inject context ║ ║ Capture output ║ ║ Generate ║
║ from memory ║ ║ extract facts ║ ║ summary ║
╚═══════╤════════╝ ╚═══════╤════════╝ ╚═══════╤════════╝
│ │ │
└────────────────────┼────────────────────┘
│
╔══════════════╧══════════════╗
║ WORKER SERVICE ║
║ http://localhost:37777 ║
╚══════════════╤══════════════╝
│
┌─────────────────────────┼─────────────────────────┐
│ │ │
▼ ▼ ▼
╔════════════════╗ ╔════════════════╗ ╔════════════════╗
║ SQLite ║ ║ ChromaDB ║ ║ Web Viewer ║
║ Database ║ ║ Vector Search ║ ║ UI ║
║────────────────║ ║────────────────║ ║────────────────║
║ Observations ║ ║ Semantic ║ ║ Timeline ║
║ Summaries ║ ║ similarity ║ ║ Search ║
║ Sessions ║ ║ matching ║ ║ Analytics ║
╚════════════════╝ ╚════════════════╝ ╚════════════════╝
⚙️ Configuration
Settings stored in ~/.moltbrain/settings.json:
┌──────────────────────────────────────┬─────────┬────────────────────────────┐
│ SETTING │ DEFAULT │ DESCRIPTION │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_WORKER_PORT │ 37777 │ Worker service port │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_CONTEXT_OBSERVATIONS │ 50 │ Max observations to inject │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_PROVIDER │ claude │ AI provider for summaries │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_PRUNE_DAYS │ 0 │ Auto-prune (0 = disabled) │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_THEME │ system │ UI theme (dark/light/sys) │
├──────────────────────────────────────┼─────────┼────────────────────────────┤
│ MOLTBRAIN_LOG_LEVEL │ info │ Logging verbosity level │
└──────────────────────────────────────┴─────────┴────────────────────────────┘
💻 CLI Commands
moltbrain stats # Show memory statistics
moltbrain export # Export to markdown
moltbrain tag <id> <t> # Tag an observation
moltbrain prune # Manual cleanup
moltbrain search <q> # Search observations
📁 Project Structure
moltbrain/
│
├── 📊 benchmarks/ Performance tests
├── 🎨 contrib/ Community modes & themes
├── 📚 docs/ Documentation
├── 📖 examples/ Usage examples & guides
│
├── 🔌 extension/
│ ├── profiles/ Observation modes
│ ├── runtime/ Worker scripts
│ ├── themes/ UI themes (dark/light)
│ ├── snippets/ Code snippets
│ └── templates/ Summary templates
│
├── 🌍 locales/ i18n (en, es, fr)
├── 🗄️ migrations/ Database migrations
├── 📋 schemas/ JSON validation schemas
├── 🛠️ scripts/ Build & utility scripts
│
├── 💻 src/
│ ├── analytics/ Token & session tracking
│ ├── cache/ Query & context caching
│ ├── core/ Core engine
│ ├── export/ JSON/CSV/MD exporters
│ ├── favorites/ Bookmark system
│ ├── filters/ Date/type/project filters
│ ├── formatters/ Output formatters
│ ├── mcp/ MCP server for OpenClaw & MoltBook
│ ├── shortcuts/ Keyboard shortcuts
│ ├── themes/ Theme system
│ └── validators/ Input validation
│
├── 🦞 integrations/
│ └── clawd/ Clawd extension & skill
│
├── 📝 templates/ Export templates
├── 🧪 tests/ Test suites
└── 🔧 tools/ CLI utilities
🔌 API
The worker exposes a REST API at http://localhost:37777:
# Health check
curl http://localhost:37777/health
# Search observations
curl "http://localhost:37777/api/search?q=authentication"
# Get timeline
curl "http://localhost:37777/api/timeline?project=my-app&days=7"
# Export data
curl "http://localhost:37777/api/export?format=json" > backup.json
# Get statistics
curl "http://localhost:37777/api/stats"
🗄️ Storage Dapp
Persistent, Postgres-backed storage for agents and apps. Live at app.moltbrain.dev/storage.
+-----------------------------------------------------------------------------+
| |
| BLOB STORAGE Content-addressed JSON blobs via SHA-256 |
| ---------- Store and retrieve data by hash. $0.01 per request. |
| |
| MEMORY SLOTS Named key-value slots for agent state |
| ---------- Allocate, write, read. Persistent across sessions. |
| |
| AGENT VAULT Per-wallet scoping with label badges |
| ---------- Connect the same wallet your agents use. |
| Browse, view, and delete what they stored. |
| |
+-----------------------------------------------------------------------------+
All endpoints are paid via x402 micropayments ($0.01 USDC on Base). Data is scoped per wallet, backed by Postgres, and survives redeploys.
Agents can tag stored data with a label (e.g. "openclaw_session", "virtuals_agent") so the vault shows what stored each item.
# Store a blob
curl -X POST https://app.moltbrain.dev/api/x402/store \
-H "X-PAYMENT: <x402_header>" \
-d '{"data": {"key": "value"}, "label": "my_agent"}'
# List your blobs
curl https://app.moltbrain.dev/api/x402/list/blobs \
-H "X-PAYMENT: <x402_header>"
# Full catalog
curl https://app.moltbrain.dev/api/x402/catalog
🎮 Virtuals Protocol Integration
GAME SDK plugin that gives any Virtuals Protocol AI agent persistent memory and storage via MoltBrain.
npm install @moltbrain/game-plugin
import { GameAgent } from "@virtuals-protocol/game";
import { MoltBrainPlugin } from "@moltbrain/game-plugin";
const moltbrain = new MoltBrainPlugin({
privateKey: process.env.AGENT_PRIVATE_KEY!, // wallet with USDC on Base
});
const agent = new GameAgent(process.env.GAME_API_KEY!, {
name: "My Agent",
goal: "Remember everything across sessions",
description: "An agent with persistent memory via MoltBrain",
workers: [moltbrain.getWorker()],
});
await agent.init();
await agent.step({ verbose: true });
9 functions available: moltbrain_chat, moltbrain_search, moltbrain_store, moltbrain_retrieve, moltbrain_allocate_slot, moltbrain_write_slot, moltbrain_read_slot, moltbrain_stats, moltbrain_capacity.
Everything the agent stores shows up in the vault dapp at app.moltbrain.dev/storage. Connect the same wallet to browse it.
See the full plugin repo: github.com/nhevers/Moltbrain-virtuals
🦞 OpenClaw Integration
Works with OpenClaw (116k+ stars) - the popular personal AI assistant!
+-----------------------------------------------------------------------------+
| |
| EXTENSION Add to OpenClaw's extensions/ folder |
| ---------- Full lifecycle hooks integration |
| |
| SKILL Install as an OpenClaw skill |
| ---------- recall_context, search_memories, save_memory tools |
| |
| MCP SERVER Protocol-based integration |
| ---------- Works with any MCP-compatible client |
| |
+-----------------------------------------------------------------------------+
Quick setup:
# As OpenClaw extension
cd ~/.openclaw/extensions
git clone https://github.com/nhevers/moltbrain.git moltbrain
cd moltbrain/integrations/openclaw
npm install && npm run build
# Enable the plugin (required for bundled installations)
pnpm openclaw plugins enable moltbrain
# Or via MCP
npm run mcp:start
Note: If installing as a bundled extension (in OpenClaw's extensions/ directory), you must explicitly enable it: pnpm openclaw plugins enable moltbrain
See integrations/openclaw/README.md for full setup guide.
📚 MoltBook Integration
Works with MoltBook - the social network for AI agents! Share memories, learn from other agents, and build collective knowledge.
Quick setup:
# Install MoltBook MCP integration
npm install --save @moltbrain/moltbook-mcp
# Configure in your MoltBrain settings
{
"MOLTBRAIN_MOLTBOOK_ENABLED": true,
"MOLTBRAIN_MOLTBOOK_API_URL": "https://moltbook.com"
}
See integrations/moltbook/README.md for full setup guide.
💻 Claude Code Integration
Works with Claude Code via the plugin marketplace:
/plugin marketplace add nhevers/moltbrain
/plugin install moltbrain
📋 Requirements
╔══════════════════════════════════════╗
║ ║
║ • Node.js 18+ or Bun 1.0+ ║
║ • OpenClaw, MoltBook, or Claude Code ║
║ ║
╚══════════════════════════════════════╝
📄 License
AGPL-3.0
README mirrored from the source repository 3 months ago. The original is authoritative.