Audrey MCP
A local-first persistent memory and continuity engine for AI agents like Claude Code and Codex. It provides a memory loop that recalls relevant project history, performs pre-action guard checks on tool calls, and consolidates learnings to prevent repeated mistakes. It uses SQLite for storage and supports CPU-based embeddings without requiring external API keys for the demo.
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 26 GitHub stars
What you can do with it
- Inject agent-scoped memory briefings at session start
- Recall relevant evidence when a user sends a prompt
- Check prior failures and trusted rules before executing tool calls
- Correlate tool outcomes to guard receipts for learning
Source and maintenance
- Last repository push
- Latest release
- v2.1.1
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
audrey 2.1.1
{
"version": "2.1.1",
"transport": "stdio",
"identifier": "audrey",
"registryType": "npm",
"environmentVariables": [
{
"name": "AUDREY_DATA_DIR",
"format": "string",
"description": "Directory for the SQLite memory store (defaults to ~/.audrey/data)"
},
{
"name": "AUDREY_AGENT",
"format": "string",
"description": "Logical memory owner used for scoped operations (defaults to local-agent)"
},
{
"name": "AUDREY_EMBEDDING_PROVIDER",
"format": "string",
"description": "local (default, on-device model), openai, gemini, or mock"
},
{
"name": "AUDREY_LLM_PROVIDER",
"format": "string",
"description": "Optional reflection/consolidation model: anthropic, openai, chatgpt, or mock; unset keeps everything local"
},
{
"name": "AUDREY_ENABLE_ADMIN_TOOLS",
"format": "string",
"description": "Set to 1 to expose the export, import, forget, and promote tools"
}
]
}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": {
"audrey-mcp": {
"command": "npx",
"args": [
"-y",
"audrey@2.1.1"
],
"env": {
"AUDREY_DATA_DIR": "<YOUR_AUDREY_DATA_DIR>",
"AUDREY_AGENT": "<YOUR_AUDREY_AGENT>",
"AUDREY_EMBEDDING_PROVIDER": "<YOUR_AUDREY_EMBEDDING_PROVIDER>",
"AUDREY_LLM_PROVIDER": "<YOUR_AUDREY_LLM_PROVIDER>",
"AUDREY_ENABLE_ADMIN_TOOLS": "<YOUR_AUDREY_ENABLE_ADMIN_TOOLS>"
}
}
}
}Cline
{
"mcpServers": {
"audrey-mcp": {
"command": "npx",
"args": [
"-y",
"audrey@2.1.1"
],
"env": {
"AUDREY_DATA_DIR": "<YOUR_AUDREY_DATA_DIR>",
"AUDREY_AGENT": "<YOUR_AUDREY_AGENT>",
"AUDREY_EMBEDDING_PROVIDER": "<YOUR_AUDREY_EMBEDDING_PROVIDER>",
"AUDREY_LLM_PROVIDER": "<YOUR_AUDREY_LLM_PROVIDER>",
"AUDREY_ENABLE_ADMIN_TOOLS": "<YOUR_AUDREY_ENABLE_ADMIN_TOOLS>"
}
}
}
}VS Code
{
"servers": {
"audrey-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"audrey@2.1.1"
],
"env": {
"AUDREY_DATA_DIR": "<YOUR_AUDREY_DATA_DIR>",
"AUDREY_AGENT": "<YOUR_AUDREY_AGENT>",
"AUDREY_EMBEDDING_PROVIDER": "<YOUR_AUDREY_EMBEDDING_PROVIDER>",
"AUDREY_LLM_PROVIDER": "<YOUR_AUDREY_LLM_PROVIDER>",
"AUDREY_ENABLE_ADMIN_TOOLS": "<YOUR_AUDREY_ENABLE_ADMIN_TOOLS>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"audrey-mcp": {
"command": "npx",
"args": [
"-y",
"audrey@2.1.1"
],
"env": {
"AUDREY_DATA_DIR": "<YOUR_AUDREY_DATA_DIR>",
"AUDREY_AGENT": "<YOUR_AUDREY_AGENT>",
"AUDREY_EMBEDDING_PROVIDER": "<YOUR_AUDREY_EMBEDDING_PROVIDER>",
"AUDREY_LLM_PROVIDER": "<YOUR_AUDREY_LLM_PROVIDER>",
"AUDREY_ENABLE_ADMIN_TOOLS": "<YOUR_AUDREY_ENABLE_ADMIN_TOOLS>"
}
}
}
}Let your agent find its tools
Find servers like Audrey MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.