# Counterparts

> Counterparts is an open-source MCP server for knowledge and memory. Local-first memory for Claude Code that scores, fades and consolidates what it keeps. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Website:** https://counterparts.ai
- **Repository:** https://github.com/mlapeter/counterparts
- **MCP Registry name:** ai.counterparts/memory
- **Categories:** knowledge and memory
- **Listing updated:** 2026-11-14

## About

Counterparts models memory on human recall. Each memory gets an importance score when written, set by the AI that lived the conversation. Memories written with expressed feeling start stronger and fade more slowly, unused ones fade over days you actually worked together, and very faint ones are filed away instead of deleted. Core memories about identity do not fade.

Recalling a memory strengthens it and pulls linked ones along, and a memory with a date attached surfaces on that day unprompted. Once a day it consolidates, merging similar memories. The site marks interference between old and new memories as still in development.

It stores data on your machine, by default under ~/.counterparts/store, needs no account or API key, and is MIT-licensed. Claude Code is the supported host, with a Claude Desktop install option on macOS.

## Features

- **Importance scoring:** The AI rates each memory when written.
- **Decay and forgetting:** Unused memories fade; core ones persist.
- **Association:** Memories used together get linked.
- **Prospective recall:** Dated memories return on the right day.
- **Daily consolidation:** Similar memories are merged offline.
- **Local storage:** Data stays on your machine.

## Good for

- Continue a project across Claude sessions
- Remember decisions and their reasons
- Resurface a dated reminder automatically
- Keep memory private with no cloud account

## Install

### Claude Code (Terminal)

```sh
claude mcp add memory -- npx -y counterparts
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
```

## FAQ

### Where is memory stored?

On your machine, by default in ~/.counterparts/store.

### Does it need an account?

No API keys and no account.

### Which clients?

Claude Code, with a Claude Desktop install on macOS.

### How is it licensed?

MIT.

### Is Counterparts free?

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

### How do I add Counterparts to Claude Code?

Run this command in your terminal: claude mcp add memory -- npx -y counterparts

### What are the best alternatives to Counterparts?

The closest alternatives to Counterparts 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/counterparts
