
mcp-automem
io.github.verygoodplugins/mcp-automem
Graph-vector memory for AI assistants using FalkorDB and Qdrant
Documentation
AutoMem MCP: Give Your AI Perfect Memory
One command. Infinite memory. Perfect recall across all your AI tools.
npx @verygoodplugins/mcp-automem@latest install
Your AI assistant now remembers everything. Forever. Across every conversation.
The guided installer โ npx @verygoodplugins/mcp-automem@latest install walks you through a private local Docker setup by default โ or hosted and existing-endpoint setups if you prefer.
Works with Claude Desktop, Cursor IDE, Claude Code, GitHub Copilot (coding agent), ChatGPT, ElevenLabs, OpenAI Codex, OpenClaw, Hermes, Grok Build, Google Antigravity - any MCP-compatible AI platform.
The Problem We Solve
Every AI conversation starts from zero. Claude forgets your coding style. Cursor can't learn your patterns. Your assistant doesn't remember yesterday's decisions.
Until now.
AutoMem MCP connects your AI to persistent memory powered by AutoMem - a graph-vector memory service.
What You Get
๐ง Persistent Memory Across Sessions
- AI remembers decisions, patterns, and context forever
- Works across all MCP platforms - Claude Desktop, Cursor, Claude Code, OpenAI Codex, OpenClaw, Hermes, Grok Build, Google Antigravity
- Cross-device sync - same memory on Mac, Windows, Linux
๐ Graph-Vector Architecture
- 11 public authorable relationship types between memories (recall results may also include read-only system/internal relations that are not valid
associate_memoriesinputs) - Research-validated approach (HippoRAG 2: 7% better associative memory)
- Sub-second retrieval even with millions of memories
๐ Works Everywhere You Code
| Platform | Support | Setup Time |
|---|---|---|
| Claude Desktop | โ Full | 30 seconds |
| Cursor IDE | โ Full | 30 seconds |
| Claude Code | โ Full | 30 seconds |
| GitHub Copilot | โ Full | 2 minutes |
| OpenAI Codex | โ Full | 30 seconds |
| OpenClaw | โ Full | 30 seconds |
| Hermes Agent | โ Full | 30 seconds |
| Grok Build | โ Full | 30 seconds |
| Google Antigravity | โ Full | 30 seconds |
| Any MCP client | โ Full | 30 seconds |
See It In Action
Claude Desktop with Personal Preferences
Claude automatically recalls memories using the Personal Preferences template
Cursor IDE with Memory Rules
Cursor uses AutoMem project rules to recall context and save durable memories during work
Claude Code with Session Memory
Session-start recall plus LLM-judged storage: Claude decides what's durable and stores it via the memory tools
More platform walkthroughs (Codex, Hermes, Antigravity, remote MCP) live in the Installation Guide.
Quick Start
1. Set Up AutoMem Service
You need a running AutoMem service (the memory backend). Choose one:
Option A: Local Development (fastest, free)
git clone https://github.com/verygoodplugins/automem.git
cd automem
make dev
Service runs at http://localhost:8001 - perfect for single-machine use.
Option B: Railway Cloud (recommended for production)
One-click deploy with $5 free credits. Typical cost: ~$0.50-1/month after trial.
๐ AutoMem Service Installation Guide - Complete setup instructions for local, Railway, Docker, and production deployments.
2. Install MCP Client
Claude Desktop - One-Click Install
Download the extension, then open Settings โ Extensions โ Advanced settings โ Install Extension in Claude Desktop and select the file:
โฌ๏ธ Download AutoMem for Claude Desktop (.mcpb)
After installing:
- Claude Desktop will prompt you for your AutoMem API URL (
http://127.0.0.1:8001for local) - Optionally enter your API Key (required for Railway, skip for local)
- Click Enable
The bundle includes a fixed version of the MCP server. To update, download and install the latest .mcpb again; restarting Claude or updating the npm package does not upgrade an installed bundle. See updating Claude Desktop for version checks and migration from JSON configuration. The AutoMem backend runs separately.
Then add the paste-ready Personal Preferences starter from templates/CLAUDE_DESKTOP_INSTRUCTIONS.md. That's it: Claude now has persistent memory and knows when to use it.
Other Platforms
Connect your AI tools to the AutoMem service you just started.
# Guided install - pick where AutoMem runs, verify it, write .env, and
# configure your agents (Codex, Claude Code, Cursor, OpenClaw, Hermes)
npx @verygoodplugins/mcp-automem@latest install
Every change is shown in a review plan before anything is written, and each
modified file keeps a .bak backup. Add --dry-run to preview, --yes to
apply non-interactively. See the Installation Guide
for all flags.
setup is an alias of install. To print config snippets again later, use npx @verygoodplugins/mcp-automem@latest config.
After an interactive install, you can start a short welcome conversation that
learns how you work and shows you the memory operations as they happen. Choose
Not now to skip it, or run npx @verygoodplugins/mcp-automem@latest welcome later.
3. Platform-Specific Setup
For Claude Code (plugin โ recommended):
# In Claude Code:
/plugin marketplace add verygoodplugins/mcp-automem
/plugin install automem@verygoodplugins-mcp-automem
Claude Code prompts for your AutoMem URL and API key at enable time, bundles the MCP server and silent recall/store-tracking hooks, and auto-updates. Prefer hooks and permissions written directly into ~/.claude/ instead? Run npx @verygoodplugins/mcp-automem@latest claude-code.
On Windows, the hook payload assumes a POSIX shell environment such as Git Bash, MSYS2, or WSL โ only bash is required (the hooks are pure bash+sed).
For Cursor IDE:
Run the guided installer from your project and select Cursor:
npx @verygoodplugins/mcp-automem@latest install
By default this installs the AutoMem Cursor plugin into ~/.cursor/plugins/local/automem (MCP server, session-start recall hook, and always-on rule) and configures it with the connection you chose. --cursor-mode files instead writes ~/.cursor/mcp.json plus project memory rules and a session-start hook. Already have an endpoint? Use npx @verygoodplugins/mcp-automem@latest cursor --endpoint https://your-automem.example.
The one-click button configures only the MCP server for a local AutoMem instance. Update its endpoint/key in Cursor if needed, then run the CLI above to add project rules and the hook:
Other platforms โ Claude Desktop (one-click .mcpb above, plus the Personal Preferences template), OpenAI Codex, Hermes Agent, Grok Build, OpenClaw, Google Antigravity, and GitHub Copilot:
๐ Full Installation Guide for every platform's setup and verification steps
Remote MCP via HTTP
An optional sidecar service (deployable to Railway or any Docker host) connects AutoMem to platforms that support remote MCP over Streamable HTTP or SSE โ ChatGPT (Developer Mode connectors), Claude.ai web and Claude Mobile, and ElevenLabs Agents.
๐ Remote MCP setup for deployment, connect URLs, and per-platform screenshots.
Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Your AI Platforms โ
โ Claude Desktop โ Cursor โ Claude Code โ
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ MCP Protocol
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ @verygoodplugins/mcp-automem (this repo) โ
โ โข Translates MCP calls โ AutoMem API โ
โ โข Platform integrations & rules โ
โ โข Handles authentication โ
โโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ HTTP API
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ AutoMem Service (separate repo) โ
โ github.com/verygoodplugins/automem โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โ โ FalkorDB โ โ Qdrant โ โ
โ โ (Graph) โ โ (Vectors) โ โ
โ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
This repo (mcp-automem):
- MCP client that connects AI platforms to AutoMem
- Platform-specific integrations (Cursor rules, Claude Code hooks, etc.)
- Setup wizards and configuration tools
- Backend memory service with graph + vector storage
- Deployment guides (local, Railway, Docker, production)
- API server with FalkorDB + Qdrant
Features
Core Memory Operations
store_memoryโ Save memories with content, tags, importance, metadata. Two modes:- Single (default): top-level
contentplus optional fields, includingembedding,t_valid,t_invalid, customid. - Batch:
memories: [...](โค500 items) for bulk ingestion. Per-itemid/embedding/t_valid/t_invalidare not supported in batch mode.
- Single (default): top-level
recall_memoryโ Three modes selected by which params you pass:- ID fetch:
memory_idโ fetches one memory by ID; updateslast_accessed. - Tag enumeration:
tags+exhaustive: trueโ paginated exact-match listing for cleanup/audit workflows where ranked recall undercounts. Pair withlimit(โค200) andoffset; returnshas_more, plusnext_offsetfor the next page while more remain. - Ranked retrieval (default): hybrid search across vector, keyword, tags, recency/state controls, score filters, and graph expansion. Supports
state_mode,recency_bias,scope_fallback,expand_respect_tags,min_score,adaptive_floor, and diagnostics such astag_scope,score_filter,query_time_ms,vector_search, and per-resultoutside_tag_scope/state_replaces.
- ID fetch:
associate_memoriesโ Create relationships (11 public authorable types; recall results may also include read-only system relations). Supports single-pair mode and batch mode viaassociations: [...](โค500) with relation-specific props likereason,context,resolution,observations,transformation, androle.update_memoryโ Modify existing memoriesdelete_memoryโ Two modes:- Single (default):
memory_idโ removes one memory and its embedding. - Bulk-by-tag:
tags: [...]โ bulk-delete all memories matching ANY tag (exact, case-insensitive). No dry-run; verify withrecall_memory({ tags, exhaustive: true })first.
- Single (default):
check_database_healthโ Monitor service health, degraded state, sync counts, vector dimensions, and enrichment diagnostics when the service provides them
Advanced Recall (v0.8.0+)
Multi-hop Reasoning - Answer complex questions like "What is Amanda's sister's career?"
mcp__memory__recall_memory({
query: "What is Amanda's sister's career?",
expand_entities: true, // Finds "Amanda's sister is Rachel" โ memories about Rachel
});
Context-Aware Coding - Recall prioritizes language and style preferences
mcp__memory__recall_memory({
query: "error handling patterns",
language: "typescript",
context_types: ["Style", "Pattern"],
});
Platform Integrations
Cursor IDE
- โ Guided setup configures the global MCP server with your endpoint and API key
- โ
Project memory rules in
.cursor/rules/automem.mdc - โ Session-start hook prompts recall, with rules as a fallback
- โ Model-judged storage during work; hooks never write memories
- โ Auto-detects project context (package.json, git remote)
Claude Code
- โ
Native plugin - MCP server, silent hooks, and skill in one
/plugin install, with enable-time config prompts and auto-updates - โ LLM-judged storage - session-start guidance nudges Claude to store, verify, and associate durable memories during normal work
- โ Memory rules in CLAUDE.md guide Claude's memory usage
GitHub Copilot
- โ
Standalone hook JSON files installed into
$COPILOT_HOME/hooks/or~/.copilot/hooks/ - โ
Memory rules template for
copilot-instructions.md - โ
Format flag -
--format cli(camelCase) or--format vscode(PascalCase) - โ
Setup:
npx @verygoodplugins/mcp-automem@latest copilot --yes
Claude Desktop
- โ Direct MCP integration
- โ Paste-ready Personal Preferences starter template
- โ Full memory API access
Why AutoMem MCP?
vs. Building Your Own
- โ 2 years of R&D already done
- โ Research-validated architecture (HippoRAG 2, MELODI, A-MEM)
- โ Working integrations across all MCP platforms
- โ Active development and community
vs. Other Memory Solutions
- โ True graph relationships (not just vector similarity)
- โ Universal MCP compatibility (works with any MCP client)
- โ 7 memory types (Decision/Pattern/Preference/Style/Habit/Insight/Context)
- โ Self-hostable ($5/month vs $150+ for alternatives)
vs. Native AI Memory
- โ Persistent across sessions (not just context window)
- โ Cross-platform (same memory in Claude, Cursor, Code)
- โ Structured relationships (not just RAG)
- โ Infinite scale (no context window limits)
Documentation
MCP Client & Integrations (this repo)
- ๐ฆ Installation Guide - MCP client setup for all platforms
- ๐ Remote MCP via HTTP - Connect ChatGPT, Claude Web/Mobile, ElevenLabs
- ๐ฏ Cursor Setup - IDE integration with rules and a session-start hook
- ๐ค Claude Code Setup - Plugin install, hooks, and memory rules
- โ ๏ธ Deprecations - History of the plugin deprecation and its reversal
- ๐ OpenAI Codex Setup - Codex CLI/IDE/Cloud integration
- ๐ช Google Antigravity Setup - Raw MCP config via Antigravity's MCP Store
- ๐ MCP Tools Reference - All memory operations
- ๐ Changelog - Release history
AutoMem Service (separate repo)
- ๐๏ธ AutoMem Service - Backend repository
- ๐ Service Installation - Local, Railway, Docker deployment
- โ๏ธ API Documentation - REST API reference
- ๐งช Evaluation Lab - Exploratory recall-quality benchmarks and ruleset A/B testing
The Science Behind AutoMem
The AutoMem service implements cutting-edge 2025 research:
- HippoRAG 2 (OSU, June 2025): Graph-vector approach achieves 7% better associative memory
- A-MEM (July 2025): Dynamic memory organization with Zettelkasten principles
- MELODI (DeepMind, 2025): 8x memory compression without quality loss
- ReadAgent (DeepMind, 2024): 20x context extension through gist memories
This MCP package provides the bridge between your AI and that research-validated memory system. The backend has also been benchmarked on the neutral Agent Memory Benchmark, including BEAM large-context scaling tiers โ reproducible end to end, so you can run it yourself.
Community & Support
- ๐ฌ Discord - Join the community, get help, share feedback
- ๐ฆ X Community - Discussion and updates
- ๐ฃ @automem_ai - Official announcements
- ๐ฆ NPM Package - This MCP client
- ๐ฌ AutoMem Service - Backend repo with deployment guides
- ๐ GitHub Issues - Bug reports and feature requests
Contributing
We welcome contributions! Please:
- Fork the repository
- Create a feature branch
- Make your changes with tests
- Submit a pull request with a Conventional Commit title such as
fix:,feat:,docs:, orchore: - Do not prefix the PR title with labels like
[codex]or[wip]because the squash-merge commit is taken from the PR title
Run npm test for the local unit and mock-host suites. For real service checks, start an
isolated AutoMem test instance, then run:
AUTOMEM_TEST_API_URL=http://127.0.0.1:18011 \
AUTOMEM_TEST_API_KEY=test-token \
AUTOMEM_REQUIRE_SERVICE=1 npm run test:integration
The integration suite creates and deletes synthetic memories, so use a disposable test
database. It probes health before collecting tests, reads vector dimensions from health
(or AUTOMEM_TEST_VECTOR_SIZE), and waits for indexing instead of using fixed sleeps.
Without AUTOMEM_REQUIRE_SERVICE=1, an unavailable service skips the optional local
suite. Required mode, also enabled by CI=true, fails on an unavailable service, zero
tests, or any skipped tests. The AutoMem service integration CI job runs required mode
against isolated FalkorDB/Qdrant services and a pinned AutoMem service checkout.
License
MIT - Because great memory should be free.
Ready to give your AI perfect memory?
npx @verygoodplugins/mcp-automem@latest install
Built with obsession. Validated by neuroscience. Powered by graph theory. Works with every MCP-enabled AI.
Designed by Jack Arturo at Very Good Plugins ๐งก
Transform your AI from a tool into a teammate. Start now.
@verygoodplugins/mcp-automemnpm install @verygoodplugins/mcp-automemRemote
Related Servers
io.github.verygoodplugins/mcp-edd
MCP server for Easy Digital Downloads REST API - sales, customers, products, analytics
io.github.verygoodplugins/mcp-evernote
Evernote note management with OAuth and ENML conversion
io.github.verygoodplugins/mcp-freescout
FreeScout ticket management with AI-powered analysis, search filters, and structured outputs.