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.
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
- 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
{
"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.
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.
Cursor
{
"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
{
"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
{
"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
{
"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.