Easy Memory MCP

Persistent semantic memory for AI agents. Connect once, remember forever.

Easy Memory is an MCP server that gives any AI agent a long-term memory: store what matters during a session, and every future session can find it again with hybrid semantic + keyword + knowledge-graph search. Memories persist in your own Apify storage — private to your account, isolated from everyone else.

• Zero configuration — embeddings run locally inside the Actor (multilingual E5 model baked into the image), no API key needed
• Hybrid retrieval — semantic vectors, BM25 full-text, entity graph expansion, fact boosting, and time-decay recency in one ranked result
• Structured facts — store subject/predicate/object triples ("project-x" → "uses" → "PostgreSQL") that boost related searches
• Multilingual — E5 embeddings work across 100+ languages
• Optional OpenAI embeddings — set EMBEDDING_PROVIDER=openai for text-embedding-3-small

Quick start

Connect your MCP client to the standby URL (streamable HTTP):

https://conscious-bouncer--easy-memory-mcp.apify.actor/mcp

with header Authorization: Bearer <your-apify-token>.

Actor console: https://console.apify.com/actors/gabGuS5mlLxydaxwJ

Claude Desktop / Claude Code

{
  "mcpServers": {
    "easy-memory": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://conscious-bouncer--easy-memory-mcp.apify.actor/mcp"],
      "env": { "MCP_REMOTE_AUTH_TOKEN": "<your-apify-token>" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "easy-memory": {
      "url": "https://conscious-bouncer--easy-memory-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer <your-apify-token>" }
    }
  }
}

Devin

Add the same URL + Bearer token in Settings → MCP Marketplace → custom server.

Tools

Tool	What it does
memory_store	Store a memory (chunked, embedded, indexed)
memory_search	Semantic search with graph + fact + recency ranking
memory_fts	Exact keyword search (BM25 / FTS5 syntax)
memory_store_fact	Store a subject/predicate/object fact
memory_facts	List facts about an entity
memory_entity	Look up an entity by name or alias
memory_status	Index statistics

Example prompts

"Remember that the staging deploy needs the DATABASE_URL secret rotated monthly."

"What did we decide about the billing retry logic?"

"Store the fact that project-atlas uses Terraform."

How your data is stored

Memories live in a SQLite index that is persisted to a named key-value store called easy-memory in your Apify account. Nobody else can read it, and you can delete it at any time from Apify Console → Storage.

Configuration (environment variables)

Variable	Default	Description
EMBEDDING_PROVIDER	local	local or openai
EMBEDDING_MODEL	Xenova/multilingual-e5-small	Local model name
OPENAI_API_KEY	—	Required when provider is openai
MEMORY_STORE_NAME	easy-memory	Name of the key-value store used for persistence

Development

npm install
npm run build
npm test            # engine smoke test (store -> search -> facts)
npm run dev         # start the HTTP server locally on :3001

Local standby simulation:

APIFY_META_ORIGIN=STANDBY ACTOR_WEB_SERVER_PORT=3001 npm start
curl -X POST http://localhost:3001/mcp \
  -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Deploy:

apify login
apify push

Pricing

Pay-per-event (configure in Apify Console — see PUBLISH.md): you are charged only for the tool calls you make. Typical usage — a few stores and a dozen searches per agent session — costs cents.

Event	Price
memory-store	$0.01
memory-search	$0.005
memory-fts	$0.002
fact-store	$0.01
lookups / status	$0.001–0.002

License

ISC. The retrieval engine is derived from the open-source easy-memory semantic memory engine.