AL Buddy Memory MCP Server

by flytomoonio.github.flytomoon/al-buddy-memoryv0.10.1

Governed local memory for AI agents: facts are retired, not overwritten, and every call is audited.

3Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install AL Buddy Memory MCP server

claude mcp add al-buddy-memory -e AL_BUDDY_MEMORY_AUDIT_KEY='<al-buddy-memory-audit-key>' -- npx -y al-buddy-memory mcp

{
  "mcpServers": {
    "al-buddy-memory": {
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<al-buddy-memory-audit-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "al-buddy-memory": {
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<al-buddy-memory-audit-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "al-buddy-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<al-buddy-memory-audit-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "al-buddy-memory": {
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<al-buddy-memory-audit-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
AL_BUDDY_MEMORY_DB	—	—	The SQLite memory file. A leading ~ is expanded.
AL_BUDDY_MEMORY_OWNER	—	—	Whose memory this is; the owner's policy applies to every call.
AL_BUDDY_MEMORY_AUDIT	—	—	Optional JSONL file for the audit chain instead of the database's own table. One writing process per file.
AL_BUDDY_MEMORY_AUDIT_KEY	—	yes	Optional HMAC key for the audit chain. Keep it away from the trail.
AL_BUDDY_MEMORY_SEMANTIC	—	—	Set to off for keyword-only recall; the on-device embedding model is then never downloaded.
AL_BUDDY_MEMORY_MODEL_CACHE	—	—	Where the on-device embedding model (about 90 MB, downloaded once) is kept.
AL_BUDDY_MEMORY_INDEX_LIMIT	—	—	Most facts embedded in the background per start (0 skips it).

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-08 · 1d ago · GitHub · v0.11.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-03 · 6d ago · official registry · v0.10.1

FAQ

›How do I install the AL Buddy Memory MCP server in Claude Code?

Run: claude mcp add al-buddy-memory -e AL_BUDDY_MEMORY_AUDIT_KEY='<al-buddy-memory-audit-key>' -- npx -y al-buddy-memory mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does AL Buddy Memory require an API key?

Yes. It expects AL_BUDDY_MEMORY_AUDIT_KEY, of which 1 is a secret.

›Can I use AL Buddy Memory as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is AL Buddy Memory in the official MCP registry?

Yes, as io.github.flytomoon/al-buddy-memory.