mcpbeat Sign in

Counterparts MCP Server

local only

Counterparts runs on your own machine — the client starts it, so there is no endpoint to ping. 1 871 installs a week from npm. Last commit 8 Nov 2026.

Local-first memory for AI: it interprets, forgets on purpose, and keeps a self across sessions.

Installs per day peak 484 · avg 181 · -0% w/w
a month agotoday
1 871
Installs / week
npm · counterparts
8
Stars
4 open issues
8 Nov 2026
Last commit
from GitHub
MIT
License
TypeScript

What the code does

We read the source, 10 h ago · rules 995398eba69f

Evidence

Things with no honest explanation: a promise that contradicts the code, code that runs at install time while hiding what it does, data leaving the machine.

Deletes files or strips permissions hosted/src/keyops.ts:372
      if (unreadable.length > 0) throw new Error(`${String(unreadable.length)} keys already in keys/keys.sqlite don't open (keys/volume.kek missing or not this volume's): remove keys/ (rm -rf /data/keys) and run recover-keys again. Nothing was written`);
Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

      const child = spawn(binary, args, { stdio: ["ignore", "ignore", "pipe"], env });
Builds a database query by concatenation hosted/src/pages.ts:375, tools/parallel/readers.ts:1068
<button type="submit" name="when" value="now">Delete everything now</button>
<p class="muted">${escapeHtml(AFTER_ERASE_WORDS)} ${escapeHtml(FORGET_WORDS)}</p></form>`

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

We found things in this code

Code changes quietly between releases, and nobody reads the diff of a dependency. We do, on every release — watch Counterparts and you get told the day something new turns up.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add memory -- npx -y counterparts
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.memory]
command = "npx"
args = ["-y", "counterparts"]
.cursor/mcp.json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "counterparts"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: COUNTERPARTS_DATA_DIR (Where the memory lives. Default: ~/.counterparts/store), COUNTERPARTS_CONFIG (The host configuration file. Default: ~/.counterparts/claude-code.json), COUNTERPARTS_UPDATE_CHECK (Set to off to stop the daily npm version check).

Alternatives to Counterparts

same job, measured the same way
Mindtrail
by rohitdeshmukh-1

Persistent, local-first memory for AI coding agents. Remember, recall and forget across sessions.

98 installs/wk local only
EchoVault Memory
by go-ports

Local-first memory for coding agents; stores decisions, bugs, and context across sessions.

local only
Maindex Smart Memory Service
by maindex

Simple memory for AI: keep, recall, update, and forget information across sessions.

answering
Nan Forget
by nanmesh

AI that remembers. Local-first cross-session, cross-project long-term memory for coding tools.

63 installs/wk local only
Mneme Memory
by modusensus

Cross-session memory for AI coding agents via six tools; local-first SQLite store.

63 installs/wk local only
amem
by sslugic

Local, private memory for coding agents: facts, skills and tasks that persist across sessions.

2 531 installs/wk local only
Ace Context MCP
by dw-dwain

Local-first memory for AI chats: save context in one chat, load it in any other via MCP.

local only
Mindswap
by shiporbleed

Local-first AI context and memory server for cross-tool coding continuity.

66 installs/wk local only

Counterparts — questions

Answers built from our own checks of this server.

Why is there no uptime for Counterparts?
Counterparts runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package counterparts was installed 1 871 times last week.
How do I connect Counterparts?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls counterparts straight from npm; nothing to host, nothing to sign up for.
How many people use Counterparts?
The npm package counterparts was installed 1 871 times in the last week. Week over week that is -0%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Counterparts open source?
Yes — it is published under the MIT licence, written in TypeScript, 8 stars on GitHub and 4 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.