Skip to main content

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.

CI codecov PyPI Docker License: MIT SafeSkill 91/100

Python SQLite MCP semantic-release Renovate

Mnemo MCP server

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

mnemo_mcp-1.25.0b1.tar.gz (59.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mnemo_mcp-1.25.0b1-py3-none-any.whl (68.7 kB view details)

Uploaded Python 3

File details

Details for the file mnemo_mcp-1.25.0b1.tar.gz.

File metadata

  • Download URL: mnemo_mcp-1.25.0b1.tar.gz
  • Upload date:
  • Size: 59.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","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

Hashes for mnemo_mcp-1.25.0b1.tar.gz
Algorithm Hash digest
SHA256 5d3d45a020f9b003317db38f3f750032f6602f2917d2e75613ccf5c5b8b87dc0
MD5 4f0714a3d4b29af1edaf9575cdbf21e6
BLAKE2b-256 c215ba80a63673d4e737ca36f1dd99b046209ea857a2abd74e080c0499c6833d

See more details on using hashes here.

File details

Details for the file mnemo_mcp-1.25.0b1-py3-none-any.whl.

File metadata

  • Download URL: mnemo_mcp-1.25.0b1-py3-none-any.whl
  • Upload date:
  • Size: 68.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.8 {"installer":{"name":"uv","version":"0.11.8","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

Hashes for mnemo_mcp-1.25.0b1-py3-none-any.whl
Algorithm Hash digest
SHA256 21c243c9d4778ec056eeeffcbff5893e80b0e83cbfd914ab712b3fcb3b6cc11e
MD5 f4d48c2367047a9f50f7649c09a0f07c
BLAKE2b-256 727826a70a0ee3ec2a31d09e980e211826da83d6f39bdb8ff59a0c6c84232a7a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page