Mnemory

by fpytloun

Not rated
GitHub

About

A self-hosted, secure, feature-rich memory system for AI agents and assistants. Provides intelligent fact extraction and deduplication, with an artifact store for detailed content.

Details

Author
fpytloun
Categories
AI, Knowledge Base, Other

Setup

Install Mnemory in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/fpytloun/mnemory

Follow the installation instructions in the repository README, then restart your MCP client.

Give your AI agents persistent memory. mnemory is a self-hostedMCPserver that adds personalization and long-term memory to any AI assistant — Claude Code, ChatGPT, Open WebUI, Cursor, or any MCP-compatible client.

Plug and play.Connect mnemory and your agent immediately starts remembering user preferences, facts, decisions, and context across conversations. No system prompt changes needed.

Self-hosted and secure.Your data stays on your infrastructure. No cloud dependencies, no third-party access to your memories.

Intelligent.Uses a unified LLM pipeline for fact extraction, deduplication, and contradiction resolution in a single call. Memories are semantically searchable, automatically categorized, and expire naturally when no longer relevant.

- Zero configuvx mnemory, connect your MCP client, done. Works out of the box with any OpenAI-compatible API.
- Intelligent extraction— A single LLM call extracts facts, classifies metadata, and deduplicates against existing memories.
- Contradiction resolution— "I drive a Skoda" + later "I bought a Tesla" = automatic update, not a duplicate.
- Two-tier memory— Fast searchable summaries in a vector store + detailed artifact storage (reports, code, research) retrieved on demand.
- AI-powered search— Multi-query semantic search with temporal awareness. Ask "What did I decide last week about the database?" and it finds the right memories.
- Memory health checks— Built-in three-phase consistency checker (fsck) detects duplicates, contradictions, quality issues, and prompt injection. Run manually or on a schedule with auto-fix.
- 10+ client support— Claude Code, ChatGPT, Open WebUI, OpenClaw, Cursor, Windsurf, Cline, OpenCode, and more. Native plugins available for automatic recall/remember.
- Built-in management UI— Dashboard, semantic search, memory browser with full CRUD, relationship graph visualization, and health check interface. No extra tools needed.
- Production ready— Qdrant for vectors, S3/MinIO for artifacts, API key or Cognis JWT authentication, per-user isolation, Kubernetes-friendly stateless HTTP.
- Secure by default— API key or Cognis JWT authentication with session-level identity binding, per-user memory isolation, anti-injection safeguards in extraction prompts.
- REST API + MCP— Dual interface with the same backend. 16 MCP tools + full REST API with OpenAPI spec. Build plugins, integrations, or use directly.
- Prometheus monitoring— Built-in/metricsendpoint with operation counters and memory gauges. Pre-built Grafana dashboard included.

mnemory needs an OpenAI-compatible API key for LLM and embeddings. It picks upOPENAI_API_KEYfrom your environment automatically.

That's it. mnemory starts onhttp://localhost:8050/mcp, stores data in~/.mnemory/.

Now connect your client — forClaude Code, add to your MCP config:

{ "mcpServers": { "mnemory": { "type": "streamable-http", "url": "http://localhost:8050/mcp", "headers": { "X-Agent-Id": "claude-code" } } } }

Start a new conversation. Memory works automatically.

Also available viaDocker, pip, or production setup with Qdrant + S3. See thefull quick start guidefor more clients and options.

Dashboard with memory breakdowns by type, category, and role

Semantic search and AI-powered find with filters

Seeall screenshots and UI featuresincluding memory browser, health checks, and artifact management.

mnemory works with any MCP-compatible client. Some clients also have dedicated plugins for automatic recall/remember.

MCP= works via Model Context Protocol (LLM-driven tool calls).Plugin= dedicated integration with automatic recall/remember (no LLM tool-calling needed).

Storing:You share information naturally. mnemory extracts individual facts, classifies them (type, category, importance), checks for duplicates and contradictions against existing memories, and stores them as searchable vectors — all in a single LLM call.

Searching:Ask a question and mnemory generates multiple search queries covering different angles and associations, runs them in parallel, and reranks results by relevance. Temporal-aware — "what did I decide last week?" just works.

Recalling:At conversation start, your agent loads pinned memories (core facts, preferences, identity) plus recent context. During conversation, relevant memories are found automatically based on what you're discussing.

Maintaining:Memories have configurable TTL — context expires in 7 days, episodic memories in 90. Frequently accessed memories stay alive (reinforcement). The built-in health checker detects and fixes duplicates, contradictions, and quality issues.

Evaluated on theLoCoMobenchmark — 10 multi-session dialogues with 1540 QA questions across 4 categories:

Configuration:gpt-5-minifor extraction,text-embedding-3-smallfor vectors.gpt-oss-120bvia Groq is a budget alternative at ~5x lower cost with comparable quality. Seeconfiguration docsfor model options andbenchmarks/for reproduction.

Self-hosted MCP server giving AI agents persistent memory — Markdown source of truth, hybrid BM25+embedding search, typed graph relations.

mem0-mcp-server — exposes Mem0 persistent semantic memory as an MCP HTTP server; supports add/search/read/update/delete operations and semantic search for agent memory.

Long-term memory system for AI agents with semantic search, context management, and multi-format storage.

Persistent memory for AI agents with Ebbinghaus forgetting curve decay, hybrid BM25 + vector + knowledge graph retrieval, temporal reasoning, and a local dashboard. 89.4% Recall@5 on LongMemEval.

Persistent cognitive memory for Claude Code. Cloud-based semantic search, Ai-powered extraction, project scoping, and compaction recovery.

Persistent memory layer for AI agents with semantic search, consolidation, and cross-session intelligence via MCP.

Local-first agent memory: a plain-Markdown Obsidian vault is the source of truth, with a rebuildable DuckDB index for hybrid BM25 + vector + graph recall.

Local Work Model for AI agents that learns from real outcomes.

Adaptive MCP memory system for AI applications. Learns which retrieval strategies work for your data, scores results using cognitive science models, builds a knowledge graph automatically, and validates every parameter change against real query history before adopting it. Patent pending.

Auditable, self-improving knowledge & memory for AI agents over MCP — citation-enforced answers and a replayable why-trace, self-hosted on Postgres.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.