# feedback-memory

> feedback-memory is an open-source MCP server for knowledge and memory. Local memory that recalls your past approvals, edits and rejections of agent drafts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, macOS, Linux, Windows
- **Website:** https://ssap-pa.github.io/self-learning-agent-setup/
- **Repository:** https://github.com/ssap-pa/self-learning-agent-setup
- **MCP Registry name:** io.github.ssap-pa/feedback-memory
- **Categories:** knowledge and memory, AI models and LLM tooling
- **Listing updated:** 2026-11-16

## About

Feedback-memory stores each decision you make on an agent's draft, whether approved, edited or rejected, together with a reason and an embedding of the task. Before the next draft, the agent can pull the closest past corrections into its prompt. Plain approvals are stored but not retrieved, since they carry no lesson.

Data lives in a local Postgres with pgvector (PGlite) under ~/.feedback-memory by default, so there is nothing to host. An optional OpenAI key switches matching to text-embedding-3-small embeddings; without it, matching falls back to offline word hashing, where similar means shared words.

The README comes from a one-person education business in Korea that approves agent drafts from a phone. In Claude Code it also ships as a plugin whose hook adds relevant corrections to each prompt even when no tool is called. A browser demo runs the whole loop in a tab.

## Features

- **Record decisions:** The record_decision tool saves an approve, edit or reject with its reason.
- **Recall corrections:** The recall_corrections tool fetches the closest past corrections before drafting.
- **Local database:** Uses PGlite with pgvector in a folder on your machine.
- **Optional embeddings:** Matches by meaning with an OpenAI key, or by shared words offline.
- **Claude Code plugin:** Loads standing rules at session start and injects corrections through a hook.

## Good for

- Stop an agent repeating wording you already rejected
- Keep customer-reply drafts consistent with past edits
- Carry standing business rules across sessions
- Try the feedback loop in the browser demo first

## Install

### Claude Code (Terminal)

```sh
claude mcp add feedback-memory --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "feedback-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "feedback-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "feedback-memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "feedback-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "feedback-memory": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb"
      ],
      "env": {
        "OPENAI_API_KEY": "<OPENAI_API_KEY>"
      }
    }
  }
}
```

## Tools

- `record_decision`: Record an approve, edit or reject decision on a draft.
- `recall_corrections`: Recall the closest past corrections for a new task.

## FAQ

### Where is the data stored?

In a local database, by default in ~/.feedback-memory, configurable with FEEDBACK_MEMORY_DIR.

### Is an API key required?

No. OPENAI_API_KEY is optional and only enables semantic matching.

### Which clients work?

The README names Claude Code, Cursor and Claude Desktop.

### Are approvals recalled?

Plain approvals are stored but not retrieved because they carry no lesson.

### Is feedback-memory free?

Yes. feedback-memory is open source, so you can use and self-host it for free.

### How do I add feedback-memory to Claude Code?

Run this command in your terminal: claude mcp add feedback-memory --env OPENAI_API_KEY='<OPENAI_API_KEY>' -- npx -y https://github.com/ssap-pa/self-learning-agent-setup/releases/download/v0.2.1/feedback-memory.mcpb

### What are the best alternatives to feedback-memory?

The closest alternatives to feedback-memory are Codebase Memory, XERJ, Claude Code Ultimate Guide, Nautilus Compass Memory and note1.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [MedXpert 图书馆连接器（通用版）](https://ai-powered.com/mcp/medxpert): MedXpert 图书馆连接器（通用版） is an open-source MCP server for knowledge and memory.
- [Context Nest](https://ai-powered.com/mcp/context-nest): Context Nest is a freemium MCP server for knowledge and memory.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/feedback-memory
