Audrey MCP Server

What is Audrey?

Audrey is a local-first memory firewall for AI agents. It provides a durable memory layer that agents check before touching tools, so they avoid repeating past mistakes, forgotten rules, and failed commands. All memory lives in a single local SQLite file—no cloud, no account, no code leaves your computer.

How to use Audrey?

Install via npm (requires Node.js 20+). Run npx audrey doctor to verify your setup, then npx audrey demo --scenario repeated-failure to see memory-before-action in action. Use npx audrey guard --tool Bash "npm run deploy" from the terminal, or install into host agents with npx audrey install --host codex (or claude-code, vscode, generic). For programmatic use, import Audrey from the audrey package in JavaScript, or install the Python client (pip install audrey-memory) and connect to the REST sidecar.

Key features of Audrey

• Local‑first, no cloud or account required.
• SQLite‑backed memory with semantic recall via sqlite‑vec.
• Preflight checks (allow/warn/block) before tool execution.
• Supports Codex, Claude Code, Cursor, Ollama, and custom agents.
• MCP stdio server, REST API, CLI, and JavaScript/Python SDKs.
• Memory model with episodic, semantic, procedural, decay, and contradiction handling.

Use cases of Audrey

• Preventing AI coding assistants from repeating the same failed commands.
• Remembering project‑specific rules across sessions.
• Blocking dangerous actions based on past failures.
• Providing durable memory for local or sidecar agent loops.
• Enforcing team guidelines without storing data in the cloud.