> install memra local

one command. 30 seconds. free forever for personal use.

runs fully on your machine. no account. no cloud. works with claude code, cursor, zed, droid, hermes agent, openclaw, and any mcp-compatible tool.

memra local

runs on your machine. stdio mcp. no account. no network. memories in ~/.memra/.

best for: offline work, debugging, solo projects, data that must never leave the laptop.

memra cloud

hosted on eu servers. http mcp. cross-device sync. team sharing. pii masking, compression, 5-factor recall.

best for: multi-device, teams, production agents, long-lived memory.

use either, or run both side-by-side — see step 02 below.

‹ 01 ›
01

install + start

one pip install, then launch the mcp server. python 3.10+ required.

terminal 
$ pip install memra-local
$ memra mcp
‹ 02 ›
02

wire it into your editor

drop the config snippet into your tool of choice. restart the editor and memra is available as an mcp server.

claude code .mcp.json (project root)  ·  or run: claude mcp add memra -- memra mcp 
{
  "mcpServers": {
    "memra": {
      "command": "memra",
      "args": ["mcp"]
    }
  }
}
cursor ~/.cursor/mcp.json 
{
  "mcpServers": {
    "memra": {
      "command": "memra",
      "args": ["mcp"]
    }
  }
}
zed settings.json 
{
  "context_servers": {
    "memra": {
      "command": {
        "path": "memra",
        "args": ["mcp"]
      }
    }
  }
}
droid (factory.ai) ~/.factory/mcp.json  ·  auto-reloads on change 
{
  "mcpServers": {
    "memra": {
      "command": "memra",
      "args": ["mcp"]
    }
  }
}
hermes agent ~/.hermes/config.yaml  ·  /reload-mcp in chat 
mcp_servers:
  memra:
    command: "memra"
    args: ["mcp"]
hermes agent — native memory provider recall + compression hooks 
$ curl -fsSL https://raw.githubusercontent.com/usememra/hermes-memra/main/install.sh | bash
$ hermes memory setup    # select "memra"

deeper than mcp: memra becomes hermes’ memory backend — auto-recall before each turn, and context that survives window compression. full hermes memory guide →

openclaw one-line cli  ·  openclaw mcp list to verify 
$ openclaw mcp set memra '{"command":"memra","args":["mcp"]}'
local + cloud, side-by-side .mcp.json (project root)  ·  gitignore this file 
{
  "mcpServers": {
    "memra": {
      "type": "http",
      "url": "https://usememra.com/mcp",
      "headers": {
        "Authorization": "Bearer memra_live_xxx"
      }
    },
    "memra-local": {
      "command": "memra",
      "args": ["mcp", "--scope", "global"]
    }
  }
}

daily writes go to memra (cloud). call memra-local tools when you need offline reproduction or to inspect raw yaml files under ~/.memra/global/.

‹ 03 ›
03

optional — auto-capture hooks

lets memra capture decisions and patterns as you work. skip it if you'd rather call memra explicitly.

terminal 
$ memra hooks install
‹ 04 ›
04

verify

check the server is up and your editor can reach it.

terminal 
$ memra status

how do i sync to cloud?

memra local is standalone — your memories stay in ~/.memra/ forever. create a free account, then run memra sync enable <namespace> --api-key memra_live_xxx to push to the cloud. cross-device + team sharing + pii masking, still eu-hosted, still privacy-first.

create free account → see plans & limits →