Skip to main content
Glama
sanchezvivi

mem0-local-mcp

by sanchezvivi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

mem0-local-mcp

A fully local, self-hosted mem0 memory server for MCP clients (Claude Code, Claude Desktop, Cursor, …).

  • Local embeddings via fastembed (ONNX, no PyTorch, no GPU) — BAAI/bge-small-en-v1.5, 384-dim. Can be used with different LLM via API key.

  • Local vector store via Qdrant on localhost.

  • Switchable extraction LLM — Anthropic Claude (default) or Google Gemini, chosen by one env var.

  • No API key needed for normal use. Reads and verbatim writes (infer=False) run entirely on your machine. A provider key is used only when you opt into LLM fact-extraction (infer=True).

Tools

Tool

Purpose

add_memory(content, user_id, agent_id?, run_id?, infer=False)

Store a memory. infer=False stores verbatim (local, no LLM); infer=True extracts/dedupes via the LLM.

search_memories(query, user_id, agent_id?, run_id?, top_k=5)

Semantic search within a scope.

list_memories(user_id, agent_id?, run_id?)

List a scope without ranking.

delete_memory(memory_id)

Delete a single memory.

Memories are scoped by any of user_id / agent_id / run_id.

Related MCP server: local-memory-mcp

Instructions for your agent

Copy the block below and paste it to your coding agent (Claude Code, Cursor, …) — it will install and verify everything for you:

Set up the mem0-local-mcp memory server on this machine for me:

1. Ensure a local Qdrant is running on port 6333: run `curl -s http://localhost:6333/`.
   If it is not running, start it with Docker:
   docker run -d --name qdrant --restart always -p 6333:6333 -v ~/.qdrant_storage:/qdrant/storage qdrant/qdrant
   If Docker is unavailable, download the Qdrant binary for my OS from
   https://github.com/qdrant/qdrant/releases and run it.
2. Ensure `uv` is installed (`which uv`); if not, install it from https://docs.astral.sh/uv/.
3. Register the MCP server at user scope:
   claude mcp add mem0 --scope user -- uvx --from git+https://github.com/sanchezvivi/mem0-local-mcp.git mem0-local-mcp
4. Verify with `claude mcp list` that `mem0` shows Connected. The first run downloads the
   embedding model (~130 MB), so allow up to a minute.
5. Reads and infer=False writes need no API key. Only if I want infer=True (LLM) extraction,
   confirm ANTHROPIC_API_KEY (or GOOGLE_API_KEY with MEM0_LLM_PROVIDER=gemini) is set in my
   environment before launching the client. Then tell me it is ready.

Prerequisites

1. A running Qdrant (pick one):

# Docker
docker run -d --name qdrant -p 6333:6333 -v ~/.qdrant_storage:/qdrant/storage qdrant/qdrant

# or the binary (macOS/Linux release from https://github.com/qdrant/qdrant/releases)
./qdrant

2. uv to run the server (uvx), or pip install mem0-local-mcp.

The embedding model (~130 MB) downloads automatically on first use.

Install in Claude Code

claude mcp add mem0 --scope user -- \
  uvx --from git+https://github.com/sanchezvivi/mem0-local-mcp.git mem0-local-mcp

For Gemini extraction, install the extra and select the provider:

claude mcp add mem0 --scope user \
  --env MEM0_LLM_PROVIDER=gemini \
  -- uvx --from "git+https://github.com/sanchezvivi/mem0-local-mcp.git#egg=mem0-local-mcp[gemini]" mem0-local-mcp

Other MCP clients

Any stdio MCP client can launch it. Example config entry:

{
  "mcpServers": {
    "mem0": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/sanchezvivi/mem0-local-mcp.git", "mem0-local-mcp"]
    }
  }
}

Configuration

All optional, with defaults:

Variable

Default

Notes

MEM0_USER_ID

default_user

Default scope when a tool call omits user_id.

MEM0_LLM_PROVIDER

anthropic

anthropic or gemini. Only used for infer=True.

MEM0_ANTHROPIC_MODEL

claude-haiku-4-5

MEM0_GEMINI_MODEL

gemini-2.5-flash

Requires the gemini extra.

MEM0_EMBED_MODEL

BAAI/bge-small-en-v1.5

Any fastembed model.

MEM0_EMBED_DIMS

384

Must match the embed model.

MEM0_QDRANT_HOST

localhost

MEM0_QDRANT_PORT

6333

MEM0_COLLECTION

mem0

ANTHROPIC_API_KEY

—

Only needed for infer=True with Anthropic.

GOOGLE_API_KEY

—

Only needed for infer=True with Gemini.

Keys are read from the process environment; nothing is written to disk by this server.

Local development

git clone https://github.com/sanchezvivi/mem0-local-mcp.git
cd mem0-local-mcp
uv venv && uv pip install -e ".[gemini]"
.venv/bin/mem0-local-mcp        # stdio server

License

MIT — see LICENSE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-recall

    Jensimogit
    A
    license
    Not graded
    quality
    C
    maintenance
    A self-hosted MCP memory server that gives AI assistants persistent, semantic memory by storing facts as vector embeddings locally, supporting semantic search and swappable embedding models.
    437 npm
    MIT

  • Recall

    cashcon57
    A
    license
    Not graded
    quality
    B
    maintenance
    A self-hosted MCP memory server with hybrid semantic and keyword search, providing persistent memory for AI coding assistants like Claude Code, Cursor, and Windsurf.
    6 npm
    3
    MIT