XMemo MCP Server

by yonroio.github.yonro/xmemov0.4.346

XMemo: user-owned agent memory to save, search, recall and manage scoped memories across AI tools.

12Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active7d ago

Install XMemo MCP server

claude mcp add client -e XMEMO_KEY='<xmemo-key>' -- npx -y @xmemo/client mcp serve

{
  "mcpServers": {
    "client": {
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "<xmemo-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "client": {
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "<xmemo-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "client": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "<xmemo-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "client": {
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client",
        "mcp",
        "serve"
      ],
      "env": {
        "XMEMO_KEY": "<xmemo-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
XMEMO_KEY	—	yes	Bearer token issued by XMemo for the stdio proxy. Optional for discovery; required for tool execution.
XMEMO_URL	—	—	Optional XMemo service base URL. Defaults to https://xmemo.dev.

Remote endpoints

streamable-httphttps://xmemo.dev/mcp

Freshness

Active — last maintenance signal 7d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-03 · 7d ago · GitHub
Latest release
2026-10-03 · 7d ago · GitHub · skill-v1.1.40
Package published
no data · npm/PyPI
Registry entry updated
2026-09-25 · 14d ago · official registry · v0.4.346

FAQ

›How do I install the XMemo MCP server in Claude Code?

Run: claude mcp add client -e XMEMO_KEY='<xmemo-key>' -- npx -y @xmemo/client mcp serve. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does XMemo require an API key?

Yes. It expects XMEMO_KEY, of which 1 is a secret.

›Can I use XMemo as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is XMemo in the official MCP registry?

Yes, as io.github.yonro/xmemo.