Peon Mem MCP Server

Local-first, hierarchical, self-improving memory for Claude Code, Codex, and any MCP client.

People who work with ai memory, codex and local first and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-15 · ★ 2 · #93 OF 304 MAINTAINED MEMORY · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Peon Mem

before you install - you'll need

Set OPENROUTER_API_KEY, PEON_PROCESSING_MODEL, PEON_EMBEDDING_MODEL, PEON_AI_MODE, PEON_EMBEDDING_MODE before connecting.

Claude Code

claude mcp add vineetv2-peon-mem -- npx -y peon-mem

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "vineetv2-peon-mem": {
      "command": "npx",
      "args": [
        "-y",
        "peon-mem"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-07-21 - young repo, little track record yet

license MIT - declared in the repository

npm package peon-mem - unscoped; check the name against the project README before installing

registry namespace io.github.VineetV2 is GitHub-verified and matches the repo owner

03 · What Peon Mem can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v1.0.9 · 2026-09-11

Installing Peon from the MCP registry or a marketplace now works. This release also carries everything from 1.0.8 (published to npm without a GitHub release): the daemon stays responsive on large brains, fully local…

v1.0.7 · 2026-09-10

Fixes a silent data-integrity bug in the embedding sidecar, makes embedding downgrades visible, and clears all dependency advisories. · Degraded embedding fallbacks no longer poison the sidecar…

v1.0.6 · 2026-09-01

Local-first memory for AI coding agents. npm install -g peon-mem · Performance - a loaded brain costs 40% less memory and loads 3.2× faster · decodeVector ended in Array.from(new Float32Array(...)), converting a…

04 · Who maintains Peon Mem

peon-mem is maintained by vineetv2. It's the only MCP server we track from this author; the repo dates to Jul 2026.

05 · Facts

repository: github.com/vineetv2/peon-mem
category: memory - ranked #93 of 304 actively-maintained memory servers as of 2026-09-18.
release cadence: 6 releases in the last 90 days (latest 2026-09-11)
registry: io.github.VineetV2/peon-mem (active, first published 2026-07-22 · 7 versions)
packages: npm:peon-mem

06 · Peon Mem FAQ

What is Peon Mem?

Local-first, hierarchical, self-improving memory for Claude Code, Codex, and any MCP client.

Is Peon Mem still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-15 and it shipped 6 releases in the last 90 days. We re-verify nightly.

How do I install Peon Mem?

Run `npx -y peon-mem`. The README documents 5 environment variables (OPENROUTER_API_KEY, PEON_PROCESSING_MODEL, PEON_EMBEDDING_MODEL…) to set first. Set OPENROUTER_API_KEY, PEON_PROCESSING_MODEL, PEON_EMBEDDING_MODEL, PEON_AI_MODE, PEON_EMBEDDING_MODE before connecting. You can also paste the ready-made client config above.

Does Peon Mem run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Peon Mem

Alternatives to Peon Mem

Maintained memory servers if Peon Mem isn't the fit.

Pairs well with

Servers that cover what Peon Mem doesn't - only shown when the pairing reason fits the companion.

More memory MCP servers · Wander Agent · Yggdrasil · Midas · Emem, The Verifiable Memory Protocol For The Physical World · AI Context Flow

More TypeScript MCP servers · Apiverket · Axis · Virtual Fly Brain · Sms · Media Context MCP · see all