# Agent Memory Bridge

> Agent Memory Bridge is an open-source MCP server for knowledge and memory. Local MCP memory that stores confirmed project decisions with their reasons for coding. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/zzhang82/agent-memory-bridge
- **MCP Registry name:** io.github.zzhang82/agent-memory-bridge
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-19

## About

The README says AMB keeps confirmed project decisions in a local store, so a later session can recall the decision and the reason behind it rather than rereading an old chat. Decisions are written explicitly with a claim and a reason, and a second process on the same home can retrieve them.

Recall is deliberate: the README is clear that connecting the server does not make an agent recall on its own, so it recommends a startup rule telling the agent to query the bridge before changing code. Repository facts read from Git are kept separate from human-confirmed decisions, and superseded records are replaced rather than silently overwritten.

It targets developers who use coding agents such as Claude Code, Cursor, Codex, Cline or VS Code and want project rules to persist across sessions. Storage is local, and the README notes that a hosted memory service is not required. It ships as a Python package with 17 public MCP tools.

## Features

- **Decision and reason storage:** Stores a confirmed project decision together with the reason it was made.
- **Recall across sessions:** A new process on the same local home can recall the stored claim and its reason.
- **Superseding outdated decisions:** Replaces an older decision while keeping it in change history.
- **Client connection helpers:** The connect command writes MCP configuration for supported clients and runs a connection check.
- **Agent handoff claims:** Short-lived handoff items can be claimed by one worker with a timeout.
- **Local-first storage:** Runs as a local stdio process; an optional HTTP gateway with bearer tokens is available for remote setups.

## Good for

- Recording why a project merge or deployment rule exists so future agent sessions follow it
- Replacing a decision that changed without losing the record of the earlier one
- Letting parallel coding agents claim handoff items so they do not duplicate work
- Configuring Claude Code, Cursor, Codex or VS Code to use a shared local project memory

## Install

### Claude Code (Terminal)

```sh
claude mcp add agent-memory-bridge -- uvx agent-memory-bridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agent-memory-bridge": {
      "command": "uvx",
      "args": [
        "agent-memory-bridge"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-memory-bridge": {
      "command": "uvx",
      "args": [
        "agent-memory-bridge"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "agent-memory-bridge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "agent-memory-bridge"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-memory-bridge": {
      "command": "uvx",
      "args": [
        "agent-memory-bridge"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agent-memory-bridge": {
      "command": "uvx",
      "args": [
        "agent-memory-bridge"
      ]
    }
  }
}
```

## Tools

- `store`: Stores a record in the memory bridge.
- `recall`: Recalls stored records, such as decisions and their reasons.
- `browse`: Browses stored memory.
- `stats`: Returns memory statistics.
- `forget`: Removes a stored record.
- `feedback`: Records feedback on a memory.
- `promote`: Promotes a memory record.
- `annotate`: Adds an annotation to a record.
- `revise`: Revises an existing record.
- `export`: Exports stored memory.
- `begin_run`: Starts a tracked work run.
- `record_run_event`: Records an event in a tracked run.
- `get_run`: Retrieves a tracked run.
- `complete_run`: Completes a tracked run.
- `claim_signal`: Claims a coordination signal.
- `extend_signal_lease`: Extends a signal lease.
- `ack_signal`: Acknowledges a coordination signal.

## FAQ

### Does the server learn decisions automatically?

No. The README states there is no automatic learning; decisions must be stored explicitly after they are confirmed.

### What does AMB require to run?

The README says it requires Python 3.11+ and Git, and is installed from the agent-memory-bridge PyPI package.

### Does it send memory to a hosted service?

The README says AMB is local-first and does not require a hosted memory service.

### How many MCP tools does it expose?

The README lists 17 public MCP tools, including store, recall, browse, stats and run and signal tools.

### Is Agent Memory Bridge free?

Yes. Agent Memory Bridge is open source, so you can use and self-host it for free.

### How do I add Agent Memory Bridge to Claude Code?

Run this command in your terminal: claude mcp add agent-memory-bridge -- uvx agent-memory-bridge

### What are the best alternatives to Agent Memory Bridge?

The closest alternatives to Agent Memory Bridge are Agent Memory MCP, MCP Memory, Cross-Agent Memory, persistent-memory and Assertion Memory.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent Memory MCP](https://ai-powered.com/mcp/agent-memory-mcp): Agent Memory MCP is an open-source MCP server for knowledge and memory.
- [MCP Memory](https://ai-powered.com/mcp/mcp-memory): MCP Memory is an open-source MCP server for knowledge and memory.
- [Cross-Agent Memory](https://ai-powered.com/mcp/cross-agent-memory): Cross-Agent Memory is an open-source MCP server for knowledge and memory.
- [persistent-memory](https://ai-powered.com/mcp/persistent-memory): persistent-memory is an open-source MCP server for knowledge and memory.
- [Assertion Memory](https://ai-powered.com/mcp/assertion-memory): Assertion Memory is a freemium MCP server for knowledge and memory.
- [Mneme Decision MCP](https://ai-powered.com/mcp/mneme-decision-mcp): Mneme Decision MCP is an open-source MCP server for developer tools.
- [Memory MCP](https://ai-powered.com/mcp/memory-mcp-2): Memory MCP is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/agent-memory-bridge
