https://github.com/n24q02m/mnemo-mcp

Persistent AI memory with hybrid search and embedded sync - open, free, unlimited
https://github.com/n24q02m/mnemo-mcp

ai-agents ai-coding ai-memory claude claude-code cursor docker hybrid-search mcp mcp-server model-context-protocol open-source python rclone sqlite

Last synced: 5 days ago
JSON representation

Persistent AI memory with hybrid search and embedded sync - open, free, unlimited

• Host: GitHub
• URL: https://github.com/n24q02m/mnemo-mcp
• Owner: n24q02m
• License: mit
• Created: 2026-02-12T08:01:04.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-04-20T22:18:11.000Z (11 days ago)
• Last Synced: 2026-04-21T00:30:05.791Z (11 days ago)
• Topics: ai-agents, ai-coding, ai-memory, claude, claude-code, cursor, docker, hybrid-search, mcp, mcp-server, model-context-protocol, open-source, python, rclone, sqlite
• Language: Python
• Homepage: https://pypi.org/project/mnemo-mcp/
• Size: 1.82 MB
• Stars: 5
• Watchers: 0
• Forks: 2
• Open Issues: 7
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: SECURITY.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          
# Mnemo MCP Server

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

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

[![CI](https://github.com/n24q02m/mnemo-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/n24q02m/mnemo-mcp/actions/workflows/ci.yml)

[![codecov](https://codecov.io/gh/n24q02m/mnemo-mcp/graph/badge.svg?token=GELGVQNMUZ)](https://codecov.io/gh/n24q02m/mnemo-mcp)

[![PyPI](https://img.shields.io/pypi/v/mnemo-mcp?logo=pypi&logoColor=white)](https://pypi.org/project/mnemo-mcp/)

[![Docker](https://img.shields.io/docker/v/n24q02m/mnemo-mcp?label=docker&logo=docker&logoColor=white&sort=semver)](https://hub.docker.com/r/n24q02m/mnemo-mcp)

[![License: MIT](https://img.shields.io/github/license/n24q02m/mnemo-mcp)](LICENSE)

[![Python](https://img.shields.io/badge/Python-3776AB?logo=python&logoColor=white)](#)

[![SQLite](https://img.shields.io/badge/SQLite-003B57?logo=sqlite&logoColor=white)](#)

[![MCP](https://img.shields.io/badge/MCP-000000?logo=anthropic&logoColor=white)](#)

[![semantic-release](https://img.shields.io/badge/semantic--release-e10079?logo=semantic-release&logoColor=white)](https://github.com/python-semantic-release/python-semantic-release)

[![Renovate](https://img.shields.io/badge/renovate-enabled-1A1F6C?logo=renovatebot&logoColor=white)](https://developer.mend.io/)



  



## 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](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

```bash

git clone https://github.com/n24q02m/mnemo-mcp.git

cd mnemo-mcp

uv sync

uv run mnemo-mcp

```

## License

MIT -- See [LICENSE](LICENSE).