Repository navigation
Home
Persistent semantic memory for AI agents and coding assistants.
MCP Memory Service is a production-ready memory layer accessible via MCP protocol, REST API, and HTTP transport. Store, retrieve, and consolidate memories with local vector search — no cloud lock-in required.
v12.6.0 (2026-11-05) · Python 3.11+ · GitHub · PyPI · Apache-2.0 License
In the media: Agents Overdrawn at the Memory Bank — Heavybit's Humans in the Loop interviews maintainer Heinrich Krupp on agent amnesia and why persistent memory is the missing infrastructure layer.
"Your project has inspired me in many ways. In my view, it's the best implementation of MCP memory I've found so far." — Michał Zubkowicz
# Python 3.11 or newer
pip install mcp-memory-service
# Start HTTP server (dashboard + REST API)
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http
# Or start MCP server (for Claude Desktop / IDE integrations)
memory serverThe anonymous HTTP example is for local use. For shared deployments, configure authentication and HTTPS.
Dashboard: http://127.0.0.1:8000
Detailed setup: Installation Guide · Platform Setup
| Capability | Details |
|---|---|
| Semantic search | Local ONNX embeddings (all-MiniLM-L6-v2), no API key needed |
| MCP + REST | Unified MCP tools · full REST API · SSE real-time updates |
| Multiple backends | SQLite-vec (local) · Hybrid (local + Cloudflare sync) · Milvus · Cloudflare |
| Memory lifecycle | Store → consolidate → quality-score → forget (dream-inspired) |
| Graph relations | Associate memories, infer relationship types, query subgraphs |
| Plugin system | Lifecycle hooks: on_store, on_retrieve, on_delete, on_consolidate
|
| 14+ integrations | Claude Desktop · Claude Code · OpenCode · LangGraph · CrewAI · AutoGen · VS Code · Cursor · and more |
| OAuth 2.1 | Dynamic Client Registration (RFC 7591) · PKCE · team collaboration |
Edit the Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"memory": {
"command": "memory",
"args": ["server"]
}
}
}# Local HTTP service for OpenCode or REST clients
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http
# Claude Code over stdio
claude mcp add memory -- memory server
# OpenCode requires the repository plugin; see the Integration Guide below.→ Integration Guide · Claude.ai Remote MCP
# Store
curl -X POST http://127.0.0.1:8000/api/memories \
-H "Content-Type: application/json" \
-d '{"content": "JWT tokens expire after 24h", "tags": ["auth"]}'
# Search
curl -X POST http://127.0.0.1:8000/api/search \
-H "Content-Type: application/json" \
-d '{"query": "authentication tokens", "limit": 5}'| Backend | Best For | Read Speed |
|---|---|---|
| SQLite-vec | Local / single-user | ~5ms |
| Hybrid | Production (local reads + Cloudflare sync) | ~5ms |
| Cloudflare | Cloud-only / edge deployment | network |
| Milvus | Large-scale / distributed | ~5ms |
# After configuring the Cloudflare credentials described in Hybrid Setup
export MCP_MEMORY_STORAGE_BACKEND=hybrid
MCP_ALLOW_ANONYMOUS_ACCESS=true memory server --http→ Advanced Configuration · Hybrid Setup
| Guide | Description |
|---|---|
| Installation Guide | All platforms, all backends |
| Platform Setup | Windows, macOS, Linux |
| Integration Guide | Claude Desktop, Claude Code, VS Code, 14+ clients |
| Claude.ai Remote MCP | HTTPS + OAuth for remote access |
| Web Dashboard Guide | Search, analytics, bulk operations |
| Advanced Configuration | Env vars, WAL mode, concurrent access |
| OAuth 2.1 Setup | Dynamic registration, PKCE, team auth |
| Guide | Description |
|---|---|
| Token-Efficient Retrieval | Bounding oversized search responses, and the memory_explore → memory_detail knowledge map |
| Memory Quality System | ONNX local scoring, Groq/Gemini tiers |
| Memory Consolidation | Dream-inspired decay, compression, forgetting |
| Graph Database Architecture | Associations, relationship inference, subgraph queries |
| Memory Hooks | Plugin lifecycle hooks |
| ONNX Quality Evaluation | Local ML ranking without cloud calls |
| Dashboard UI Guide | Web interface walkthrough |
| Resource | Description |
|---|---|
| Troubleshooting | Common issues, backend diagnostics, lock errors |
| FAQ | Frequently asked questions |
| Examples | Code examples and workflows |
| Development Reference | API reference, hooks, debugging |
| Performance Optimization | Query tuning, caching, scaling |
| Development Roadmap | Upcoming features and milestones |
| Architecture Diagram | Interactive Archify diagram of the runtime architecture, as embedded in a local Hermes agent |
| Deployment Landscape | GitHub Actions, GitLab mirror, PyPI, Docker Hub and Cloudflare Pages |
Setup & Backends
- Hybrid Setup Configuration
- Cloudflare Backup Sync
- Backend Synchronization Guide
- Windows Hybrid Setup
Features
- Complete Feature List
- Natural Memory Triggers
- Metadata Compression System
- Quality Hooks Integration
- Context Provider Workflow
- AppleScript Integration
- Screenshot Automation
Community & Governance
- Agent Integrations Guide
- Using Agents in Other Repos
- Contributor Promotion
- Issue Templates
- Pull Request Templates
- CONTRIBUTING ↗
┌─────────────────────────┐ ┌──────────────────────────┐ ┌─────────────────┐
│ AI Clients │ │ MCP Memory Service │ │ Storage Backend │
│ │ │ v12.6.0 │ │ │
│ • Claude Desktop │◄──►│ • MCP tools │◄──►│ • Hybrid │
│ • Claude Code │ │ • REST API (port 8000) │ │ (5ms + sync) │
│ • OpenCode │ │ • OAuth 2.1 │ │ • SQLite-vec │
│ • LangGraph / CrewAI │ │ • Plugin hooks │ │ • Cloudflare │
│ • VS Code / Cursor │ │ • Memory consolidation │ │ • Milvus │
│ • 14+ AI apps │ │ • Quality scoring (ONNX) │ │ │
│ • Web Dashboard │ │ • Graph relations │ │ WAL mode │
└─────────────────────────┘ └──────────────────────────┘ └─────────────────┘
- Rebuild existing entity graphs with
memory_quality(action="rebuild_entities"); preview is the default. - Manage registered OAuth clients with
memory oauth list-clientsandmemory oauth delete-client. - Dashboard follows the system theme and adds Russian; translations cover more dashboard controls.
- HTTP
/mcppreserves tool annotations, answersping, and exposes all graph actions. - Local unauthenticated HTTP/SSE transports validate Host and Origin to block cross-origin and DNS-rebinding attacks.
- Python 3.11+ is required; upgrade Python before updating from a 3.10 installation.
- Dashboard delta-sync status, entity-tag include/exclude filters and opt-in belief deduplication.
Full history: CHANGELOG ↗
- Bug? → GitHub Issues
- Question? → GitHub Discussions
- Not working? → Troubleshooting
- Contribute → CONTRIBUTING ↗ · Contributor Promotion