memex
Stores notes as Markdown files compatible with Obsidian vaults, enabling integration with Obsidian.
memex
Local-first second brain with semantic search. Stores notes as Markdown files and indexes them with a local ML model — no cloud, no API keys.
Works as an MCP server for Claude Code and Claude Desktop, and as a standalone CLI.
Features
Semantic search — multilingual embeddings via
paraphrase-multilingual-MiniLM-L12-v2(Korean + English, runs fully offline)Obsidian-compatible — notes saved as
.mdfiles in your vault directoryMCP server — Claude can save and search your second brain mid-conversation
CLI — add, search, list, show, delete notes from the terminal
Local DB — SQLite +
sqlite-vecstored inside the vault at.memex/memex.db
Install
npm install -g @evan-moon/memexOn first run the embedding model (~120MB) is downloaded once to ~/.memex/models/.
CLI
memex add # interactive prompt
memex add --title "Note title" --content "..."
memex add --title "Note title" --file ./note.md
memex add --title "Note title" --content "..." --folder "projects/memex"
memex list # recent 10 notes
memex list --limit 20
memex search "semantic search query" # multilingual
memex search "지식 관리" --limit 10
memex show <id>
memex delete <id>
memex delete --yes <id> # skip confirmation
memex config show
memex config set vault-path ~/Documents/Second\ Brain
memex mcp install # register with Claude Code
memex mcp path # print MCP binary pathMCP server
Claude Code
memex mcp installOr manually:
claude mcp add memex -- node "$(memex mcp path)"Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"memex": {
"command": "node",
"args": ["<path from `memex mcp path`>"]
}
}
}Available tools
Tool | Description |
| Save a note (title + markdown content + optional folder) |
| Semantic search across all notes |
| List recent notes |
| Get full content of a note by ID |
| Delete a note by ID |
Configuration
Config is stored at ~/.memex/config.json.
Key | Default | Description |
|
| Directory where |
memex config set vault-path ~/my-vaultArchitecture
~/.memex/
config.json — vault path and settings
models/ — cached embedding model
<vault>/
*.md — notes (Obsidian-compatible)
.memex/
memex.db — SQLite DB (notes table + sqlite-vec embeddings)Monorepo packages:
Package | Role |
| SQLite schema, drizzle queries, sqlite-vec integration |
| Local embedder via @huggingface/transformers |
| Config, path helpers, shared utilities |
| MCP server (bundled into CLI dist) |
License
MIT
This server cannot be installed
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/evan-moon/memex'
If you have feedback or need assistance with the MCP directory API, please join our Discord server