# Polypack Memory

> Polypack Memory is an MCP server for knowledge and memory. Persistent graph-based memory for MCP clients, stored locally and shared across agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, Self-hosted, Linux
- **Repository:** https://github.com/imattau/polypack-mcp
- **MCP Registry name:** io.github.imattau/polypack-mcp
- **Categories:** [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-15

## About

Polypack Memory keeps what an assistant learns in a local Polypack store so Claude, Codex and other clients can share durable memory. For one client it runs over stdio; for several it runs as a long-lived local HTTP service at 127.0.0.1:8765, set up with `polypack-mcp setup` as a systemd user service or installed from Debian and RPM packages. The README warns not to start two processes on the same store.

Seventeen tools cover storing, updating, linking, recalling and pruning memories. Memories fall into entity, episodic, procedural and semantic classes, with preferences stored as procedural. Recall mixes lexical and activation scores and can add optional local semantic retrieval using Qwen3-Embedding-0.6B, which is downloaded once and unloaded after 15 minutes idle. Retrieval can pull in neighbouring memories along graph edges, and a token budget caps what is returned. Feedback reinforces useful memories, while supersession and consolidation keep history through graph edges.

Context works as a soft preference, with strict_context available for hard isolation. Deleting is permanent and needs confirmation, and memory_suppress retains history instead.

## Features

- **Durable local store:** Mutations checkpoint immediately and the store flushes on shutdown.
- **Shared HTTP mode:** One local service lets Claude and Codex use the same memory.
- **Graph links:** Link, unlink and traverse memories, with neighbours returned on recall.
- **Adaptive recall:** Scores combine lexical, activation and optional semantic matches.
- **Token-budgeted context:** memory_context never returns an item that would exceed the budget.
- **History-preserving edits:** Supersede and consolidate memories without losing earlier versions.
- **Context scoping:** Prefer or strictly isolate memories by context namespace.

## Good for

- Give Claude and Codex a common long-term memory on one machine
- Store project conventions as procedural memories
- Record a fix and link it to the earlier memory it answers
- Turn on local semantic search without a hosted embedding service
- Retire an outdated fact while keeping its history

## Install

### Claude Code (Terminal)

```sh
claude mcp add polypack-mcp -- uvx polypack-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "polypack-mcp": {
      "command": "uvx",
      "args": [
        "polypack-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "polypack-mcp": {
      "command": "uvx",
      "args": [
        "polypack-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "polypack-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "polypack-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "polypack-mcp": {
      "command": "uvx",
      "args": [
        "polypack-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "polypack-mcp": {
      "command": "uvx",
      "args": [
        "polypack-mcp"
      ]
    }
  }
}
```

## Tools

- `memory_store`: Stores a memory.
- `memory_get`: Fetches a memory by exact id.
- `memory_update`: Updates context, confidence, provenance or metadata.
- `memory_list_contexts`: Lists context namespaces.
- `memory_delete`: Permanently deletes a memory after confirmation.
- `memory_recall`: Recalls memories by query with optional neighbours.
- `memory_context`: Returns memories within a token budget.
- `memory_feedback`: Records whether a memory was useful.
- `memory_suppress`: Suppresses a memory while keeping history.
- `memory_supersede`: Replaces a memory's content while keeping history.
- `memory_consolidate`: Consolidates memories.
- `memory_link`: Links two memories.
- `memory_unlink`: Removes a link between memories.
- `memory_thread`: Reads a thread of linked memories.
- `memory_store_batch`: Stores several memories at once.
- `memory_link_batch`: Links several memories at once.
- `graph_query`: Runs graph queries such as relationship diagnostics.

## FAQ

### How do I install Polypack Memory?

pip install 'polypack-mcp[polypack]', or use the Debian, RPM or APT repository packages.

### Can two clients share memory?

Yes, run the shared Streamable HTTP service and give both clients its URL instead of a command.

### Is a model required?

No. The default uses graph, activation and lexical retrieval; Qwen embeddings are optional.

### How many tools are there?

Seventeen, from memory_store to graph_query.

### Is deletion reversible?

No. memory_delete is permanent and needs confirm=true; memory_suppress keeps history.

### How do I add Polypack Memory to Claude Code?

Run this command in your terminal: claude mcp add polypack-mcp -- uvx polypack-mcp

### What are the best alternatives to Polypack Memory?

The closest alternatives to Polypack Memory are Compound Memory, VelesDB Memory, persistent-memory, Memory MCP and Wontopos.

## Where this comes from

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

## Alternatives

- [Compound Memory](https://ai-powered.com/mcp/compound-memory): Compound Memory is an open-source MCP server for knowledge and memory.
- [VelesDB Memory](https://ai-powered.com/mcp/velesdb-memory): VelesDB Memory is an 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.
- [Memory MCP](https://ai-powered.com/mcp/memory-mcp-2): Memory MCP is an open-source MCP server for knowledge and memory.
- [Wontopos](https://ai-powered.com/mcp/wontopos): Wontopos is a freemium MCP server for knowledge and memory.
- [Hypermnesia MCP](https://ai-powered.com/mcp/hypermnesia-mcp): Hypermnesia MCP is an open-source MCP server for knowledge and memory.

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