recall-mcp

MCP server for Recall — a self-hosted AI memory system built on Qdrant + Neo4j + PostgreSQL + Ollama.

Gives Claude Code and claude.ai direct access to your memory store via 7 tools.

Tools

| Tool | Description | |------|-------------| | recall_store | Store a memory (facts, decisions, fixes, preferences) | | recall_search | Semantic search — summaries by default, full=true for complete content | | recall_get | Fetch a specific memory by ID | | recall_timeline | Browse memories chronologically | | recall_rehydrate | Chronological briefing for a time window | | recall_health | Check system health (Qdrant, Neo4j, Redis, Postgres, Ollama) | | recall_profile_proposals | List/approve/reject CLAUDE.md profile update proposals |

Install

Claude Code (stdio, local)

claude mcp add recall -- npx recall-mcp

Then set the required env vars in ~/.claude/settings.json:

{
  "mcpServers": {
    "recall": {
      "command": "npx",
      "args": ["recall-mcp"],
      "env": {
        "RECALL_HOST": "http://localhost:8200",
        "RECALL_API_KEY": "your-64-char-hex-api-key"
      }
    }
  }
}

Manual (if you've cloned the Recall repo)

{
  "mcpServers": {
    "recall": {
      "command": "node",
      "args": ["/path/to/recall/mcp-server/index.js"],
      "env": {
        "RECALL_HOST": "http://localhost:8200",
        "RECALL_API_KEY": "your-64-char-hex-api-key"
      }
    }
  }
}

claude.ai remote connector

Use the HTTP/SSE endpoint built into the Recall API (requires OAuth 2.0 PKCE):

• MCP URL: https://your-recall-host/mcp/
• Auth: OAuth 2.0 — the connector will prompt for authorization; use your RECALL_API_KEY as the client_id

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | RECALL_HOST | Yes | Base URL of your Recall API — no trailing slash | | RECALL_API_KEY | Yes | Your Recall system API key (the 64-char hex key from .env, not a dashboard user key) |

Finding Your API Key

The API key is the RECALL_API_KEY value in your Recall .env file:

# In your Recall project directory
grep RECALL_API_KEY .env

Requirements

• Node.js 18+
• A running Recall instance

License

MIT