freshcrate
Skin:/
Home > MCP Servers > Memori

Memori

Memori is agent-native memory infrastructure. A SQL-native, LLM-agnostic layer that turns agent execution and conversation into structured, persistent state for production systems.

Why this rank:Strong adoptionRecent releaseHealthy release cadence

Description

Memori is agent-native memory infrastructure. A SQL-native, LLM-agnostic layer that turns agent execution and conversation into structured, persistent state for production systems.

README

Memori Labs

Memory from what agents do, not just what they say.

Memori plugs into the software and infrastructure you already use. It is LLM, datastore and framework agnostic and seamlessly integrates into the architecture you've already designed.

Memori Cloud — Zero config. Get an API key and start building in minutes.

Memori%2fLabs%2FMemori | Trendshif

PyPI version NPM version Downloads License Discord

Give a Star Choose memory that performs

Memori Labs


Getting Started

Installation

TypeScript SDK
npm install @memorilabs/memori
Python SDK
pip install memori

Quickstart

Sign up at app.memorilabs.ai, get a Memori API key, and start building. Full docs: memorilabs.ai/docs/memori-cloud/.

Set MEMORI_API_KEY and your LLM API key (e.g. OPENAI_API_KEY), then:

TypeScript SDK
import { OpenAI } from 'openai';
import { Memori } from '@memorilabs/memori';

// Requires MEMORI_API_KEY and OPENAI_API_KEY in your environment
const client = new OpenAI();
const mem = new Memori().llm
  .register(client)
  .attribution('user_123', 'support_agent');

async function main() {
  await client.chat.completions.create({
    model: 'gpt-4o-mini',
    messages: [{ role: 'user', content: 'My favorite color is blue.' }],
  });
  // Conversations are persisted and recalled automatically in the background.

  const response = await client.chat.completions.create({
    model: 'gpt-4o-mini',
    messages: [{ role: 'user', content: "What's my favorite color?" }],
  });
  // Memori recalls that your favorite color is blue.
}
Python SDK
from memori import Memori
from openai import OpenAI

# Requires MEMORI_API_KEY and OPENAI_API_KEY in your environment
client = OpenAI()
mem = Memori().llm.register(client)

mem.attribution(entity_id="user_123", process_id="support_agent")

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "My favorite color is blue."}]
)
# Conversations are persisted and recalled automatically.

response = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "What's my favorite color?"}]
)
# Memori recalls that your favorite color is blue.

Explore the Memories

Use the Dashboard — Memories, Analytics, Playground, and API Keys.

Tip

Want to use your own database? Check out docs for Memori BYODB here: https://memorilabs.ai/docs/memori-byodb/.

LoCoMo Benchmark

Memori was evaluated on the LoCoMo benchmark for long-conversation memory and achieved 81.95% overall accuracy while using an average of 1,294 tokens per query. That is just 4.97% of the full-context footprint, showing that structured memory can preserve reasoning quality without forcing large prompts into every request.

Compared with other retrieval-based memory systems, Memori outperformed Zep, LangMem, and Mem0 while reducing prompt size by roughly 67% vs. Zep and lowering context cost by more than 20x vs. full-context prompting.

Read the benchmark overview, see the results, or download the paper.

"Memori's average accuracy along with the standard deviation"

OpenClaw (Persistent Memory for Your Gateway)

By default, OpenClaw agents forget everything between sessions. The Memori plugin fixes that. It captures durable facts and preferences after each conversation, then injects the most relevant context back into future prompts automatically.

No changes to your agent code or prompts are required. The plugin hooks into OpenClaw's lifecycle, so you get structured memory, Intelligent Recall, and Advanced Augmentation with a drop-in plugin.

openclaw plugins install @memorilabs/openclaw-memori
openclaw plugins enable openclaw-memori

openclaw config set plugins.entries.openclaw-memori.config.apiKey "YOUR_MEMORI_API_KEY"
openclaw config set plugins.entries.openclaw-memori.config.entityId "your-app-user-id"

openclaw gateway restart

For setup and configuration, see the OpenClaw Quickstart. For architecture and lifecycle details, see the OpenClaw Overview.

MCP (Connect Your Agent in One Command)

Your agent forgets everything between sessions. Memori fixes that. It remembers your stack, your conventions, and how you like things done so you stop repeating yourself.

Works for solo developers and teams. Your agent learns coding patterns, reviewer preferences, and project conventions over time. For teams, that means shared context that new engineers pick up on day one instead of absorbing tribal knowledge over months.

If you use Claude Code, Cursor, Codex, Warp, or Antigravity, you can connect Memori with no SDK integration needed:

claude mcp add --transport http memori https://api.memorilabs.ai/mcp/ \
  --header "X-Memori-API-Key: ${MEMORI_API_KEY}" \
  --header "X-Memori-Entity-Id: your_username" \
  --header "X-Memori-Process-Id: claude-code"

For Cursor, Codex, Warp, and other clients, see the MCP client setup guide.

Attribution

To get the most out of Memori, you want to attribute your LLM interactions to an entity (think person, place or thing; like a user) and a process (think your agent, LLM interaction or program).

If you do not provide any attribution, Memori cannot make memories for you.

TypeScript SDK
mem.attribution("12345", "my-ai-bot");
Python SDK
mem.attribution(entity_id="12345", process_id="my-ai-bot")

Session Management

Memori uses sessions to group your LLM interactions together. For example, if you have an agent that executes multiple steps you want those to be recorded in a single session.

By default, Memori handles setting the session for you but you can start a new session or override the session by executing the following:

TypeScript SDK
mem.resetSession();
// or
mem.setSession(sessionId);
Python SDK
mem.new_session()
# or
mem.set_session(session_id)

Supported LLMs

  • Anthropic
  • Bedrock
  • DeepSeek
  • Gemini
  • Grok (xAI)
  • OpenAI (Chat Completions & Responses API)

(unstreamed, streamed, synchronous and asynchronous)

Supported Frameworks

  • Agno
  • LangChain
  • Pydantic AI

Supported Platforms

  • DeepSeek
  • Nebius AI Studio

Examples

For more examples and demos, check out the Memori Cookbook.

Memori Advanced Augmentation

Memories are tracked at several different levels:

  • entity: think person, place, or thing; like a user
  • process: think your agent, LLM interaction or program
  • session: the current interactions between the entity, process and the LLM

Memori's Advanced Augmentation enhances memories at each of these levels with:

  • attributes
  • events
  • facts
  • people
  • preferences
  • relationships
  • rules
  • skills

Memori knows who your user is, what tasks your agent handles and creates unparalleled context between the two. Augmentation occurs in the background incurring no latency.

By default, Memori Advanced Augmentation is available without an account but rate limited. When you need increased limits, sign up for Memori Advanced Augmentation or use the Memori CLI:

# Install the CLI via pip to manage your account
python -m memori sign-up <email_address>

Memori Advanced Augmentation is always free for developers!

Once you've obtained an API key, set the following environment variable (used by both Python and TypeScript SDKs):

export MEMORI_API_KEY=[api_key]

Managing Your Quota

At any time, you can check your quota using the Memori CLI (works for both SDKs):

python -m memori quota

Or by checking your account at https://app.memorilabs.ai/. If you have reached your IP address quota, sign up and get an API key for increased limits.

If your API key exceeds its quota limits we will email you and let you know.

Command Line Interface (CLI)

The Memori CLI is the unified tool for managing your account, keys, and quotas across all SDKs. To use it, execute the following from the command line:

# Requires Python installed
python -m memori

This will display a menu of the available options. For more information about what you can do with the Memori CLI, please reference Command Line Interface.

Contributing

We welcome contributions from the community! Please see our Contributing Guidelines for details on:

  • Setting up your development environment
  • Code style and standards
  • Submitting pull requests
  • Reporting issues

Support


License

Apache 2.0 - see LICENSE

Release History

VersionChangesUrgencyDate
v3.3.6## What's Changed * Release version 3.3.6rc1 with exclusive Rust `fastembed` backend for … by @devwdave in https://github.com/MemoriLabs/Memori/pull/561 * fix mysql datetime type by @devwdave in https://github.com/MemoriLabs/Memori/pull/562 * Release version 3.3.6, updating changelog and project files to reflec… by @devwdave in https://github.com/MemoriLabs/Memori/pull/563 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.3.5...v3.3.6High5/28/2026
v3.3.4## What's Changed * Revise README to open all Python SDK sections by default by @jayyao18 in https://github.com/MemoriLabs/Memori/pull/479 * Revert Trendshift alt text on Memori readme by @jayyao18 in https://github.com/MemoriLabs/Memori/pull/488 * Merged Python and TypeScript BYODB pages, updated AI models in examples by @jayyao18 in https://github.com/MemoriLabs/Memori/pull/494 * Remove irrelevant providers from the Install your LLM Provider section by @jayyao18 in https://github.com/MemorHigh5/20/2026
v3.3.3## What's Changed * TS OC Changes for Cloud by @rpkruse in https://github.com/MemoriLabs/Memori/pull/450 * Fixed native rust build path for ts by @rpkruse in https://github.com/MemoriLabs/Memori/pull/451 * Enhance CI workflows for multi-platform Rust builds and Android support by @devwdave in https://github.com/MemoriLabs/Memori/pull/452 * Added Agent trace & execution under core concepts and TiDB in BYODB docs by @jayyao18 in https://github.com/MemoriLabs/Memori/pull/457 * Update OC QuicksHigh5/5/2026
v3.3.2## What's Changed * Bump version to 3.3.2 by @devwdave in https://github.com/MemoriLabs/Memori/pull/443 * Feature/3.3.2 rust core opt out by @devwdave in https://github.com/MemoriLabs/Memori/pull/444 * Enhance Android support for Rust-backed Python extension by @devwdave in https://github.com/MemoriLabs/Memori/pull/445 * Ci required checks merge gate by @devwdave in https://github.com/MemoriLabs/Memori/pull/447 * Lazy rust core init by @devwdave in https://github.com/MemoriLabs/Memori/pull/High4/29/2026
v3.3.1## What's Changed * Update embedding configurations to suppress progress output by @devwdave in https://github.com/MemoriLabs/Memori/pull/416 * Refactor publish workflow and update package management by @devwdave in https://github.com/MemoriLabs/Memori/pull/426 * Add macOS 15 Intel to the publish workflow matrix by @devwdave in https://github.com/MemoriLabs/Memori/pull/428 * Enhance CI workflows and update dependencies by @devwdave in https://github.com/MemoriLabs/Memori/pull/432 * feat: suHigh4/27/2026
v3.3.0## What's Changed * feat: add MongoDB driver handshake metadata (DriverInfo) by @alexbevi in https://github.com/MemoriLabs/Memori/pull/407 * Rust core by @devwdave in https://github.com/MemoriLabs/Memori/pull/408 * Dependency updates by @devwdave in https://github.com/MemoriLabs/Memori/pull/409 * Update CI workflows to skip manylinux tests for heavy ML dependencies by @devwdave in https://github.com/MemoriLabs/Memori/pull/410 * Bump version to 3.3.0 in pyproject.toml and add skip_integratioHigh4/20/2026
v3.3.0rc1## What's Changed * feat: add MongoDB driver handshake metadata (DriverInfo) by @alexbevi in https://github.com/MemoriLabs/Memori/pull/407 * Rust core by @devwdave in https://github.com/MemoriLabs/Memori/pull/408 * Dependency updates by @devwdave in https://github.com/MemoriLabs/Memori/pull/409 * Update CI workflows to skip manylinux tests for heavy ML dependencies by @devwdave in https://github.com/MemoriLabs/Memori/pull/410 ## New Contributors * @alexbevi made their first contribution High4/20/2026
v3.2.8## What's Changed * Add question template for GitHub issues to enhance user support by @devwdave in https://github.com/MemoriLabs/Memori/pull/399 * Update banner to fix typo (changed extraction to execution) by @jayyao18 in https://github.com/MemoriLabs/Memori/pull/400 * Bump version to 3.2.8 and update aiohttp dependency to version 3.13.2 by @devwdave in https://github.com/MemoriLabs/Memori/pull/405 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.2.7...v3.2.8High4/13/2026
v3.2.7**Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.2.6...v3.2.7High4/6/2026
v3.2.6Release v3.2.6Medium4/6/2026
v3.2.5## What's Changed * Llm qol updates by @devwdave in https://github.com/MemoriLabs/Memori/pull/387 * fix(embeddings): suppress transformers warnings during model loading by @Jah-yee in https://github.com/MemoriLabs/Memori/pull/332 * refactor(embeddings): improve logging configuration for SentenceTrans… by @devwdave in https://github.com/MemoriLabs/Memori/pull/388 * refactor(api): enhance type annotations and docstrings for Memori and…. by @devwdave in https://github.com/MemoriLabs/Memori/Medium4/6/2026
v3.2.4## What’s New This release improves documentation across the project, expands benchmark coverage, and enhances recall summaries with better deduplication and date handling. It also includes new integration tests and internal cleanup work. ### Documentation - Expanded Memori MCP and OpenClaw documentation - Improved MCP setup guidance and added a dedicated MCP section to the README - Added new integration docs for LangChain, Notion, and Slack - Updated LoCoMo benchmark documentation andMedium3/25/2026
v3.2.3## What's Changed * Gemini wrapper bug fix… by @devwdave in https://github.com/MemoriLabs/Memori/pull/349 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.2.2...v3.2.3Low3/10/2026
v3.2.2## What's Changed * Add DeepSeek docs and update supported providers by @sandhub in https://github.com/MemoriLabs/Memori/pull/325 * Bug: Cloud recall update by @devwdave in https://github.com/MemoriLabs/Memori/pull/339 * Docs minor updates by @sandhub in https://github.com/MemoriLabs/Memori/pull/342 * Save human readable fact creation… by @devwdave in https://github.com/MemoriLabs/Memori/pull/346 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.2.1...v3.2.2Low3/10/2026
v3.2.1## What's Changed * Update MANIFEST.in to exclude TypeScript SDK and modify _handler.py t… by @devwdave in https://github.com/MemoriLabs/Memori/pull/316 * fix: Support new google.genai SDK in LangChain ChatGoogleGenerativeAI adapter by @SolariSystems in https://github.com/MemoriLabs/Memori/pull/305 * chore: Update CI workflow to include Python versions 3.13 and 3.14 by @devwdave in https://github.com/MemoriLabs/Memori/pull/317 * chore: Add support for Python versions 3.13 and 3.14 in classifLow2/25/2026
v3.2.0## What's Changed * fix: support MongoDB ObjectId in search (fixes int() conversion error) by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/275 * Update: Integration tests by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/280 * fix: Langchain register error with better error handling (#234) by @Harshit28j in https://github.com/MemoriLabs/Memori/pull/241 * Fix MongoDB migration IndexOptionsConflict (duplicate index keys) by @colygon in https://github.com/MemoriLabs/Low2/23/2026
v3.1.6## What's Changed * Recall api by @devwdave in https://github.com/MemoriLabs/Memori/pull/271 * feat: add context management and connection handling to Memori and Db… by @devwdave in https://github.com/MemoriLabs/Memori/pull/272 * refactor: replace FactCandidates with list of FactCandidate in search… by @devwdave in https://github.com/MemoriLabs/Memori/pull/273 * Bump version from 3.1.5 to 3.1.6 by @devwdave in https://github.com/MemoriLabs/Memori/pull/279 **Full Changelog**: https://gitLow1/28/2026
v3.1.5**Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.1.4...v3.1.5Low1/21/2026
v3.1.4## What's Changed * Integration tests (#256) by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/257 * Refactor embeddings and search utilities in Memori by @devwdave in https://github.com/MemoriLabs/Memori/pull/261 * feat: Add OpenAI Responses client support by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/260https://github.com/MemoriLabs/Memori/pull/262 * feat: support oceanbase/seekdb by @PsiACE in https://github.com/MemoriLabs/Memori/pull/266 * Embedding updatesLow1/21/2026
v3.1.3## What's Changed * Benchmarking by @devwdave in https://github.com/MemoriLabs/Memori/pull/240 * Enhance embedding configuration and error handling by @devwdave in https://github.com/MemoriLabs/Memori/pull/243 * Add debug logging support and enhance documentation for Memori SDK by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/244 * Add AzureOpenAI client support by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/248 * Fix google-genai response handling by @harshalLow1/5/2026
v3.1.2## What's Changed * add link to the memori cookbook by @Boburmirzo in https://github.com/MemoriLabs/Memori/pull/236 * Add new exception classes for Memori API error handling by @devwdave & @HyoTaek-Jang in https://github.com/MemoriLabs/Memori/pull/239 ## New Contributors * @HyoTaek-Jang made their first contribution in https://github.com/MemoriLabs/Memori/pull/239 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.1.1...v3.1.2Low12/17/2025
v3.1.1## What's Changed * Update documentation to include Nebius AI Studio support and adjust P… by @devwdave in https://github.com/MemoriLabs/Memori/pull/226 * add troubleshooting guide by @Boburmirzo in https://github.com/MemoriLabs/Memori/pull/217 * Deprecation warning by @devwdave in https://github.com/MemoriLabs/Memori/pull/228 * Quota Testing Bug by @devwdave in https://github.com/MemoriLabs/Memori/pull/229 * fix: automatic memory injection for Google GenAI provider (#215) by @KarthikeyaKolLow12/12/2025
v3.1.0## What's Changed * add Digital Ocean gradient example. by @harshalmore31 in https://github.com/MemoriLabs/Memori/pull/211 * LLM instrument registration by @devwdave in https://github.com/MemoriLabs/Memori/pull/213 * Refactor augmentation payload to include hashed entity and process ID… by @devwdave in https://github.com/MemoriLabs/Memori/pull/219 * Add augmentation.wait() method to gracefully handle interrupt/termination@devwdave in https://github.com/MemoriLabs/Memori/pull/222 * Update TeLow12/9/2025
v3.0.6## What's Changed * Add issue templates to be used to submit bugs and feature request by @devwdave in https://github.com/MemoriLabs/Memori/pull/207 * add quickstart page by @Boburmirzo in https://github.com/MemoriLabs/Memori/pull/209 * Pymongo bug by @devwdave in https://github.com/MemoriLabs/Memori/pull/210 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.0.5...v3.0.6Low12/4/2025
v3.0.5## What's Changed * Unsupported Error Handling in https://github.com/MemoriLabs/Memori/pull/206 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.0.4...v3.0.5Low12/3/2025
v3.0.4## What's Changed * Agno Support by @devwdave in https://github.com/MemoriLabs/Memori/pull/205 **Full Changelog**: https://github.com/MemoriLabs/Memori/compare/v3.0.3...v3.0.4Low12/3/2025
v3.0.3Release v3.0.3Low12/3/2025
v3.0.2Release v3.0.2Low12/2/2025
v3.0.1Release v3.0.1Low12/2/2025
v3.0.0Release v3.0.0Low12/2/2025
v2.1.1Release Notes – v2.1.1 Bug Fixes Patch Release: Fixed hostname resolution issues with MongoDB Atlas connections using modern mongodb+srv:// format. MongoDB Atlas Connection Fixes - Fixed DNS Resolution Warnings: Resolved hostname resolution warnings when connecting to MongoDB Atlas using mongodb+srv:// URIs - Improved SRV URI Parsing: Enhanced connection string parsing logic to properly handle DNS seedlist discovery - Better Error Handling: Added proper exception handling for sLow10/2/2025
v2.1.0Release Notes – v2.1.0 This update adds MongoDB support to the memori, enabling seamless operation with both SQL and MongoDB backends. Key Changes • Database Abstraction: Automatic detection of backend type (SQL or MongoDB) in ConsciousAgent, MemoryAgent, and MemorySearchEngine. • Refactored Logic: Unified ingestion, initialization, and promotion flows with backend-specific methods. • Unified Search: MemorySearchEngine.execute_search now works across both SQL and MongoDB with fallbacLow9/22/2025
v2.0.1memory_tool v2.0.1 – Patch Release This patch improves logging, error handling, and database search logic for memory retrieval. Changes • Added detailed debug logs for memory searches, category filtering, and retrieval functions. • Improved error reporting with stack traces and contextual details for primary and fallback search strategies. • Refined category extraction logic with better fallback handling. • Enhanced database query construction for SQLite and MySQL (including COALESLow9/22/2025
v2.0.0We are releasing **Memori v2**, a major upgrade focused on modularity, performance, and improved memory handling. ## Highlights * Refactored into a more modular and maintainable codebase. * Simplified memory architecture for easier usage and extension. * Long-term memory now works without `conscious_ingest=true`, aligning with the original design. * Improved performance with fewer API calls and optimized search. ## Changes * **`conscious_ingest` behavior redesigned**: * OrigiLow9/5/2025
v1.0.1Release v1.0.1 See [CHANGELOG.md](https://github.com/GibsonAI/memori/blob/main/CHANGELOG.md) for details. Low8/4/2025
v1.0.0## [1.0.0] - 2025-08-03 ### 🎉 **Production-Ready Memory Layer for AI Agents** Complete professional-grade memory system with modular architecture, comprehensive error handling, and configuration management. ### ✨ Core Features - **Universal LLM Integration**: Works with ANY LLM library (LiteLLM, OpenAI, Anthropic) - **Pydantic-based Intelligence**: Structured memory processing with validation - **Automatic Context Injection**: Relevant memories automatically added to conversations - **MultipLow8/4/2025

Dependencies & License Audit

Loading dependencies...

Similar Packages

AstrBotAgentic IM Chatbot infrastructure that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨v4.25.3
agentpoolA unified agent orchestration hub that lets you configure and manage multiple AI agents (native, ACP, AGUI, Claude Code) via YAML, and exposes them through standardized protocols (ACP/OpenCode Server)v2.9.18
mcp-reticle📊 Analyze and visualize Model Context Protocol (MCP) traffic with RETICLE, your Wireshark-like tool for better network insights.main@2026-06-07
Awesome-RAG-Production🚀 Build and scale reliable Retrieval-Augmented Generation (RAG) systems with this curated collection of tools, frameworks, and best practices.main@2026-06-07
agentroveYour own Claude Code UI, sandbox, in-browser VS Code, terminal, multi-provider support (Anthropic, OpenAI, GitHub Copilot, OpenRouter), custom skills, and MCP servers.v0.1.38

More in MCP Servers

claude-plugins-officialOfficial, Anthropic-managed directory of high quality Claude Code Plugins.
langchain4jLangChain4j is an open-source Java library that simplifies the integration of LLMs into Java applications through a unified API, providing access to popular LLMs and vector databases. It makes impleme
hyperframesWrite HTML. Render video. Built for agents.
claude-code-guideClaude Code Guide - Setup, Commands, workflows, agents, skills & tips-n-tricks go from beginner to power user!