mem0-mcp
v0.2.0
Published
A dedicated mem0 MCP server with file-backed storage and Ollama embeddings.
Readme
mem0-mcp
A dedicated repository for the mem0 MCP server we developed: file-backed scoped memory records, mandatory checkpoint provenance, and Ollama-based embeddings.
Release notes and migration details live in CHANGELOG.md.
Installation
npm install -g mem0-mcpRelease Highlights (0.2.0)
- Deterministic memory deduplication through a stable
dedupe_keyinstead of similarity-based soft merging. - Config-aware
setup_wizardthat validates and pulls the configured embedding model instead of assuming one hard-coded model. - Abortable Ollama requests with
MEM0_OLLAMA_TIMEOUT_MSacross health checks and embedding calls. - MCP
initializenow reports the real package version frompackage.json. - Package metadata is ready for installable distribution, including repository, homepage, and issue tracker links.
Architecture boundary
This repository contains only the mem0 server/runtime surface:
src/transport/mcp-server.tssrc/adapters/sqlite/sqlite-memory-store.tssrc/adapters/ollama/ollama-embedder.tssrc/bin/mem0-mcp.ts
Generic MCP transport mechanics are implemented inside this repository under src/transport/, so mem0-mcp can build and install independently without requiring sibling repositories.
Environment
MEM0_STORE_PATH(default:~/.copilot/mem0)OLLAMA_BASE_URL(default:http://127.0.0.1:11434)MEM0_EMBED_MODEL(default:qwen3-embedding:latest)MEM0_OLLAMA_TIMEOUT_MS(default:10000)
Commands
npm install
npm run typecheck
npm run build
npm test
npm run mem0:mcpHost Launch Guidance
If an MCP host isolates native modules poorly, prefer launching the server as node <absolute-path>/dist/bin/mem0-mcp.js instead of a symlinked shim. This avoids native module resolution failures around better-sqlite3 in some host runtimes.
Tool surface
healthmemory_storememory_recallmemory_searchmemory_updatememory_forgetsetup_wizard
License
This project is licensed under the Business Source License 1.1 (BSL).
You may use this software for non-commercial and non-production purposes (e.g., development, testing, research, and personal projects) free of charge.
Commercial and production use is strictly prohibited without prior written authorization.
On March 22, 2030 (the Change Date), this license automatically converts to the Apache License, Version 2.0.
