Docs/Getting Started

Quick Start

Get r3 running in 30 seconds - zero configuration required.

Step 1: Run r3

Bash
1npx r3

That's it! r3 automatically starts with an embedded Redis server. No setup needed.

Step 2: Configure Claude Desktop

Open your Claude Desktop configuration:

Bash
1# macOS/Linux
2nano ~/.claude/claude_desktop_config.json
3

4# Windows
5notepad %APPDATA%\Claude\claude_desktop_config.json

Add this simple configuration:

JSON
1{
2  "mcpServers": {
3    "recall": {
4      "command": "npx",
5      "args": ["r3"]
6      // No environment variables needed!
7    }
8  }
9}

Step 3: Restart Claude Desktop

  1. Quit Claude Desktop completely
  2. Start Claude Desktop again
  3. Open a new conversation

Step 4: Test it works

In Claude Desktop, type:

TEXT
1Remember that my name is Sarah and I prefer Python for data science projects.

Claude should respond confirming the memory was stored. Then start a new conversation and ask:

TEXT
1What's my name and preferred programming language?

Claude should recall your information from the previous conversation.

What's happening

When you ask Claude to remember something:

  1. Local Storage: Memory is instantly stored in the embedded Redis server
  2. Persistence: Data persists between sessions on your local machine
  3. Fast Retrieval: Memories are retrieved in under 5ms
  4. Zero Dependencies: Everything runs locally, no external services needed

Optional: Advanced Configuration

Enable Cloud Sync

Want to backup memories to the cloud? Add a Mem0 API key:

JSON
1{
2  "mcpServers": {
3    "recall": {
4      "command": "npx",
5      "args": ["r3"],
6      "env": {
7        "MEM0_API_KEY": "mem0_..." // Get free at mem0.ai
8      }
9    }
10  }
11}

Use External Redis

For production or shared Redis:

JSON
1{
2  "mcpServers": {
3    "recall": {
4      "command": "npx",
5      "args": ["r3"],
6      "env": {
7        "REDIS_URL": "redis://your-redis-server:6379"
8      }
9    }
10  }
11}

Set a user ID

To separate memories by user:

JSON
1{
2  "env": {
3    "MEM0_API_KEY": "mem0_...",
4    "REDIS_URL": "redis://localhost:6379",
5    "MEM0_USER_ID": "sarah_chen"
6  }
7}

Enable debug logging

To see what's happening:

JSON
1{
2  "env": {
3    "MEM0_API_KEY": "mem0_...",
4    "REDIS_URL": "redis://localhost:6379",
5    "DEBUG": "recall:*"
6  }
7}

Common issues

"Redis connection failed"

Redis isn't running. Start it with:

Bash
1redis-server

"Invalid API key"

Check your Mem0 API key:

  1. Starts with mem0_
  2. No extra spaces
  3. Copied correctly

"MCP server not found"

Claude Desktop needs a restart:

  1. Quit Claude Desktop (Cmd+Q / Alt+F4)
  2. Start it again
  3. Check the config file is valid JSON

Next steps

Now that Recall is working:

Get help

IntroductionInstallation