Koskamo

Al Buddy Memory MCP

A portable, governed, model-agnostic memory server for AI agents. It ensures facts are invalidated rather than overwritten, maintains raw text as the source of truth, and provides an auditable, versioned JSON export format. The system supports temporal queries and runs locally on SQLite without requiring vendor keys or cloud dependencies.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Al Buddy Memory MCP logo, by flytomoonCommunity listingLocal stdioSource reviewed; not executedPublished by flytomoon
Vendor documentation

Checks and signals

Each line is separate evidence, not a trust score.

  • Popularity 3 GitHub stars

What you can do with it

  • Store and retrieve AI agent memories with full provenance tracking
  • Query historical states of facts using temporal axes
  • Export agent memory state to a documented JSON format
  • Run local memory storage without vendor lock-in

Source and maintenance

Community listingRegistry 0.12.0Apache-2.0
Last repository push
Latest release
v0.12.0
Maintenance checked

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

al-buddy-memory 0.12.0

npmnpx
al-buddy-memory package definition
{
  "version": "0.12.0",
  "transport": "stdio",
  "identifier": "al-buddy-memory",
  "runtimeHint": "npx",
  "registryType": "npm",
  "packageArguments": [
    {
      "type": "positional",
      "value": "mcp",
      "description": "Start the stdio MCP server (the same server as the al-buddy-memory-mcp executable)."
    }
  ],
  "environmentVariables": [
    {
      "name": "AL_BUDDY_MEMORY_DB",
      "format": "filepath",
      "default": "~/.al-buddy-memory/brain.db",
      "description": "The SQLite memory file. A leading ~ is expanded."
    },
    {
      "name": "AL_BUDDY_MEMORY_OWNER",
      "default": "owner",
      "description": "Whose memory this is; the owner's policy applies to every call."
    },
    {
      "name": "AL_BUDDY_MEMORY_AUDIT",
      "format": "filepath",
      "description": "Optional JSONL file for the audit chain instead of the database's own table. One writing process per file."
    },
    {
      "name": "AL_BUDDY_MEMORY_AUDIT_KEY",
      "description": "Optional HMAC key for the audit chain. Keep it away from the trail."
    },
    {
      "name": "AL_BUDDY_MEMORY_SEMANTIC",
      "default": "on",
      "description": "Set to off for keyword-only recall; the on-device embedding model is then never downloaded."
    },
    {
      "name": "AL_BUDDY_MEMORY_MODEL_CACHE",
      "format": "filepath",
      "default": "~/.al-buddy-memory/models",
      "description": "Where the on-device embedding model (about 90 MB, downloaded once) is kept."
    },
    {
      "name": "AL_BUDDY_MEMORY_INDEX_LIMIT",
      "default": "5000",
      "description": "Most facts embedded in the background per start (0 skips it)."
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · repository · passed · metadata changed · updated
  • · backfill · recorded · Pre-expansion baseline; unobserved rich metadata remains unknown

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.
Cursor configuration
{
  "mcpServers": {
    "al-buddy-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory@0.12.0",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_DB": "<YOUR_AL_BUDDY_MEMORY_DB>",
        "AL_BUDDY_MEMORY_OWNER": "<YOUR_AL_BUDDY_MEMORY_OWNER>",
        "AL_BUDDY_MEMORY_AUDIT": "<YOUR_AL_BUDDY_MEMORY_AUDIT>",
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<YOUR_AL_BUDDY_MEMORY_AUDIT_KEY>",
        "AL_BUDDY_MEMORY_SEMANTIC": "<YOUR_AL_BUDDY_MEMORY_SEMANTIC>",
        "AL_BUDDY_MEMORY_MODEL_CACHE": "<YOUR_AL_BUDDY_MEMORY_MODEL_CACHE>",
        "AL_BUDDY_MEMORY_INDEX_LIMIT": "<YOUR_AL_BUDDY_MEMORY_INDEX_LIMIT>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.
Cline configuration
{
  "mcpServers": {
    "al-buddy-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory@0.12.0",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_DB": "<YOUR_AL_BUDDY_MEMORY_DB>",
        "AL_BUDDY_MEMORY_OWNER": "<YOUR_AL_BUDDY_MEMORY_OWNER>",
        "AL_BUDDY_MEMORY_AUDIT": "<YOUR_AL_BUDDY_MEMORY_AUDIT>",
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<YOUR_AL_BUDDY_MEMORY_AUDIT_KEY>",
        "AL_BUDDY_MEMORY_SEMANTIC": "<YOUR_AL_BUDDY_MEMORY_SEMANTIC>",
        "AL_BUDDY_MEMORY_MODEL_CACHE": "<YOUR_AL_BUDDY_MEMORY_MODEL_CACHE>",
        "AL_BUDDY_MEMORY_INDEX_LIMIT": "<YOUR_AL_BUDDY_MEMORY_INDEX_LIMIT>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.
VS Code configuration
{
  "servers": {
    "al-buddy-memory-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory@0.12.0",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_DB": "<YOUR_AL_BUDDY_MEMORY_DB>",
        "AL_BUDDY_MEMORY_OWNER": "<YOUR_AL_BUDDY_MEMORY_OWNER>",
        "AL_BUDDY_MEMORY_AUDIT": "<YOUR_AL_BUDDY_MEMORY_AUDIT>",
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<YOUR_AL_BUDDY_MEMORY_AUDIT_KEY>",
        "AL_BUDDY_MEMORY_SEMANTIC": "<YOUR_AL_BUDDY_MEMORY_SEMANTIC>",
        "AL_BUDDY_MEMORY_MODEL_CACHE": "<YOUR_AL_BUDDY_MEMORY_MODEL_CACHE>",
        "AL_BUDDY_MEMORY_INDEX_LIMIT": "<YOUR_AL_BUDDY_MEMORY_INDEX_LIMIT>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.
Claude Desktop configuration
{
  "mcpServers": {
    "al-buddy-memory-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "al-buddy-memory@0.12.0",
        "mcp"
      ],
      "env": {
        "AL_BUDDY_MEMORY_DB": "<YOUR_AL_BUDDY_MEMORY_DB>",
        "AL_BUDDY_MEMORY_OWNER": "<YOUR_AL_BUDDY_MEMORY_OWNER>",
        "AL_BUDDY_MEMORY_AUDIT": "<YOUR_AL_BUDDY_MEMORY_AUDIT>",
        "AL_BUDDY_MEMORY_AUDIT_KEY": "<YOUR_AL_BUDDY_MEMORY_AUDIT_KEY>",
        "AL_BUDDY_MEMORY_SEMANTIC": "<YOUR_AL_BUDDY_MEMORY_SEMANTIC>",
        "AL_BUDDY_MEMORY_MODEL_CACHE": "<YOUR_AL_BUDDY_MEMORY_MODEL_CACHE>",
        "AL_BUDDY_MEMORY_INDEX_LIMIT": "<YOUR_AL_BUDDY_MEMORY_INDEX_LIMIT>"
      }
    }
  }
}

Let your agent find its tools

Find servers like Al Buddy Memory MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.