Open-source MCP Server for persistent AI memory with embedded sync
Project description
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
License
MIT -- See LICENSE.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mnemo_mcp-1.16.0.tar.gz.
File metadata
- Download URL: mnemo_mcp-1.16.0.tar.gz
- Upload date:
- Size: 48.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8d3414060cc3be6ee00ef8bbfe44fcf8be9e51fe2ae74afe55626478eb85aa85
|
|
| MD5 |
b0ffa3282c0bb116e8c05799b4c24902
|
|
| BLAKE2b-256 |
28193c0dff67c6d01e0766b7ddd28a0357ce2c7d9c75748357c9a43d53653691
|
File details
Details for the file mnemo_mcp-1.16.0-py3-none-any.whl.
File metadata
- Download URL: mnemo_mcp-1.16.0-py3-none-any.whl
- Upload date:
- Size: 56.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.3 {"installer":{"name":"uv","version":"0.11.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9f95238a37728138736322e0bce92b2a013182354a7d468e01f45de1b21849fc
|
|
| MD5 |
d8a72db18eec631e02edffb5b706a64d
|
|
| BLAKE2b-256 |
76fcab113d36266b15fc069f546bfb5b59f0a25b682ca51941fe657b1bd612aa
|