Connect Claude Code

This tutorial walks through installing eden-memory and wiring it to Claude Code CLI so your agent can remember and recall facts across conversations.

Prerequisites

A Linux or macOS machine.
Claude Code CLI installed and able to run /mcp or /memory.
Shell access to run curl and eden-memory.

1. Install the binary

Run the installer:

curl -fsSL https://0d3sa.com/eden-memory/install.sh | sh

This downloads the right binary for your platform, verifies its checksum, and installs it to ~/.local/bin/eden-memory. If your terminal is interactive, the installer prompts for EDEN_ORG_ID and writes it to ~/.eden-memory/.env. Leave it empty to configure later, or pre-set it for non-interactive installs:

export EDEN_ORG_ID=your-org
curl -fsSL https://0d3sa.com/eden-memory/install.sh | sh

Make sure ~/.local/bin is on your PATH, or use the full path in the next step.

2. Wire the MCP server

The easiest way is to run the setup helper from the project directory you launch Claude Code in:

cd ~/project-a
eden-memory setup claude

This does three things:

Adds or updates the current project in ~/.claude.json as a stdio MCP server.
Removes any stale eden-memory entry from ~/.claude/settings.json.
Installs fallback slash commands in ~/.claude/commands/.

If you prefer to edit ~/.claude.json manually, add this under projects["<cwd>"]["mcpServers"]:

{
  "eden-memory": {
    "command": "/home/yourname/.local/bin/eden-memory",
    "args": [
      "--db",
      "/home/yourname/.eden-memory/default.db"
    ],
    "env": {
      "EDEN_LOG_LEVEL": "INFO"
    }
  }
}

Use absolute paths and replace yourname with your actual username. Do not add --mcp-stdio; it is not a valid flag.

3. Restart Claude Code

A full restart is required for tool discovery. Exit completely and reopen Claude Code.

4. Verify the connection

At the start of a session, ask Claude to check health:

Run eden_health.

You can also use the fallback slash command if MCP tools are not yet loaded:

/eden-health

You should see a JSON health report. If it fails, re-run the install:

curl -fsSL https://0d3sa.com/eden-memory/install.sh | sh

Do not proceed with memory-dependent work until eden_health succeeds.

5. Remember and recall your first fact

Ask Claude to store a preference:

Remember that I prefer Python examples and short sentences.

Then start a new conversation and ask:

What do you know about my communication preferences?

Claude should recall the preference from the local store.

Expected output

eden-memory version prints a version string.
eden_health returns status: ok.
A remembered fact is returned when you ask about it in a new session.

Connect Claude Code

Connect Claude Code

Prerequisites

1. Install the binary

2. Wire the MCP server

3. Restart Claude Code

4. Verify the connection

5. Remember and recall your first fact

Expected output

Next steps