Memory MCP

A persistent memory MCP service for Claude Code. Automatically saves conversations and retrieves relevant history across sessions. Its 17 documented tools cover memory, episode, entity, cache. It runs locally over stdio via the published package.

People connecting memory tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-07-26 · ★ 11 · #121 OF 259 MAINTAINED MEMORY · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install Memory MCP

Claude Code

claude mcp add chenxiaofie-memory-mcp -- uvx chenxiaofie-memory-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "chenxiaofie-memory-mcp": {
      "command": "uvx",
      "args": [
        "chenxiaofie-memory-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package chenxiaofie-memory-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.chenxiaofie is GitHub-verified and matches the repo owner

03 · What Memory MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can start a new episode, close and archive current episode, get current active episode, and add a knowledge entity.

The 17 tools it gives your agent

Extracted from the project's README - what memory-mcp lets an agent do.

memory_start_episode: - Start a new episode
memory_close_episode: - Close and archive current episode
memory_get_current_episode: - Get current active episode
memory_add_entity: - Add a knowledge entity
memory_confirm_entity: - Confirm a detected entity candidate
memory_reject_candidate: - Reject a false detection
memory_deprecate_entity: - Mark an entity as outdated
memory_get_pending: - List pending entity candidates
memory_recall: - Semantic search across episodes and entities
memory_search_by_type: - Search entities by type
memory_get_episode_detail: - Get full episode details
memory_list_episodes: - List all episodes chronologically

show all 17 tools

memory_stats: - Get system statistics
memory_encoder_status: - Check vector encoder status
memory_cache_message: - Manually cache a message
memory_clear_cache: - Clear message cache
memory_cleanup_messages: - Clean up old cached messages

Latest releases

v0.3.3 · 2026-07-26

v0.3.2 · 2026-02-13

v0.1.2 · 2026-02-12

Changes · Lighten SessionStart hook by removing MemoryManager/chromadb dependency (~50ms vs 18s+) · Add stale episode detection (30min threshold) · Update hooks documentation with execution time info · Add GitHub…

04 · Who maintains Memory MCP

memory-mcp is maintained by chenxiaofie. It's the only MCP server we track from this author; the repo dates to Feb 2026.

05 · Facts

repository: github.com/chenxiaofie/memory-mcp
category: memory - ranked #121 of 259 actively-maintained memory servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-07-26)
registry: io.github.chenxiaofie/memory-mcp (active, first published 2026-02-06 · 3 versions)
packages: pypi:chenxiaofie-memory-mcp

06 · Memory MCP FAQ

Is Memory MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-26 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Memory MCP do?

With this server connected, an agent can start a new episode, close and archive current episode, get current active episode, and add a knowledge entity.

How do I install Memory MCP?

Run `uvx chenxiaofie-memory-mcp`. You can also paste the ready-made client config above.

Does Memory MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Memory MCP

Alternatives to Memory MCP

Maintained memory servers if Memory MCP isn't the fit.

Pairs well with

Servers that cover what Memory MCP doesn't - only shown when the pairing reason fits the companion.

More memory MCP servers · Nautilus Compass · Wisdomgraph · Fit LLM · Cpersona · Growmos

More Python MCP servers · Chipzen · Korea Data Suite · Server Sigma · Argus Testing - Autonomous QA MCP · see all