mnemo-mcp 1.25.0b2

Open-source MCP Server for persistent AI memory with embedded sync

Mnemo MCP Server

mcp-name: io.github.n24q02m/mnemo-mcp

Persistent AI memory with hybrid search and embedded sync. Open, free, unlimited.

Features

• Hybrid search -- FTS5 full-text + sqlite-vec semantic + reranking for precision
• Knowledge graph -- Automatic entity extraction and relation tracking across memories
• Importance scoring -- LLM-scored 0.0-1.0 per memory for smarter retrieval
• Auto-archive -- Configurable age + importance threshold to keep memory clean
• STM-to-LTM consolidation -- LLM summarization of related memories in a category
• Duplicate detection -- Warns before adding semantically similar memories
• Zero config -- Built-in local Qwen3 embedding + reranking, no API keys needed. Optional cloud providers (Jina AI, Gemini, OpenAI, Cohere)
• Multi-machine sync -- JSONL-based merge sync via embedded rclone (Google Drive, S3, Dropbox)
• Proactive memory -- Tool descriptions guide AI to save preferences, decisions, facts

Setup

With AI Agent -- copy and send this to your AI agent:

Please set up mnemo-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/mnemo-mcp/main/docs/setup-with-agent.md

Manual Setup -- follow docs/setup-manual.md

Tools

Tool	Actions	Description
memory	add, search, list, update, delete, export, import, stats, restore, archived, consolidate	Core memory CRUD, hybrid search, import/export, archival, and LLM consolidation
config	status, sync, set, warmup, setup_sync	Server status, trigger sync, update settings, pre-download embedding model, authenticate sync provider
help	--	Full documentation for any tool

MCP Resources

URI	Description
mnemo://stats	Database statistics and server status
mnemo://recent	10 most recently updated memories

MCP Prompts

Prompt	Parameters	Description
save_summary	summary	Generate prompt to save a conversation summary as memory
recall_context	topic	Generate prompt to recall relevant memories about a topic

Security

• Graceful fallbacks -- Cloud → Local embedding, no cross-mode fallback
• Sync token security -- OAuth tokens stored at ~/.mnemo-mcp/tokens/ with 600 permissions
• Input validation -- Sync provider, folder, remote validated against allowlists
• Error sanitization -- No credentials in error messages

Build from Source

git clone https://github.com/n24q02m/mnemo-mcp.git
cd mnemo-mcp
uv sync
uv run mnemo-mcp

Trust Model

This plugin implements TC-Local (machine-bound, single trust principal). See mcp-core/docs/TRUST-MODEL.md for full classification.

Mode	Storage	Encryption	Who can read your data?
stdio (default)	~/.mnemo-mcp/config.json	AES-GCM, machine-bound key	Only your OS user (file perm 0600)
HTTP self-host	Same as stdio	Same	Only you (admin = user)

License

MIT -- See LICENSE.