Home › Knowledge & Memory › XMemo

XMemo

Shared, governed long-term memory for AI agents across tools and sessions via MCP and REST.

TypeScript Cloud Remote

★ 12 stars Last pushed 2026-09-24 License: MIT

View repository → Website →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Remote (streamable-http)

https://xmemo.dev/mcp Requires auth (checked 2026-09-24)

Claude Code:

claude mcp add --transport http memory-os-cli https://xmemo.dev/mcp --header "Authorization: <YOUR_VALUE>" --header "X-Memory-OS-Agent-ID: <YOUR_VALUE>" --header "X-Memory-OS-Agent-Instance-ID: <YOUR_VALUE>" --header "X-Memory-OS-Device-ID: <YOUR_VALUE>" --header "X-Memory-OS-Device-Label: <YOUR_VALUE>"

Or add to your MCP client config:

{
  "mcpServers": {
    "memory-os-cli": {
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "<YOUR_VALUE>",
        "X-Memory-OS-Agent-ID": "<YOUR_VALUE>",
        "X-Memory-OS-Agent-Instance-ID": "<YOUR_VALUE>",
        "X-Memory-OS-Device-ID": "<YOUR_VALUE>",
        "X-Memory-OS-Device-Label": "<YOUR_VALUE>"
      }
    }
  }
}

Authorization required secret — Bearer token issued by XMemo; send as an Authorization Bearer value.
X-Memory-OS-Agent-ID — Optional stable agent family id for attribution, for example 'claude-code' or 'copilot-cli'.
X-Memory-OS-Agent-Instance-ID — Optional stable local installation id for attribution; XMemo hashes it server-side.
X-Memory-OS-Device-ID — Optional stable local device id for attribution; use a non-secret machine or installation identifier.
X-Memory-OS-Device-Label — Optional human-readable local device label for attribution, for example 'MacBook Pro' or 'PC A'.

Package (npm 0.4.181)

npx -y @xmemo/client@0.4.181

Or add to your MCP client config:

{
  "mcpServers": {
    "memory-os-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@xmemo/client@0.4.181"
      ],
      "env": {
        "XMEMO_KEY": "<YOUR_VALUE>",
        "XMEMO_URL": "<YOUR_VALUE>"
      }
    }
  }
}

XMEMO_KEY secret — 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.

This server takes extra arguments — see its repository.