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

Context All Your Agents Can ShareAgents share what they learn, hand off work, and hold it when you switch models. Start with 5 GB free.fulcradynamics.comAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-recall

    Jensimogit
    A
    license
    Not graded
    quality
    D
    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.
    47 npm
    MIT

  • Recall

    cashcon57
    A
    license
    Not graded
    quality
    C
    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.
    3 npm
    4
    MIT