All MCP Servers
AI & MemoryMCP RegistrypypiB · 72

CP Memory MCP server

io.github.CJhuochai · Updated

Local-first, governable long-term memory for AI coding agents

At a glance

CP Memory is an MCP server in the AI & Memory category. It runs locally over stdio via `uvx cp-memory-mcp`, and declares no required credentials. It scores B (72/100) on the MCP Skills Hub health score as of Oct 28, 2026.

Source 1GitHub stars

One-click install

Opens your editor and pre-fills the config. Your editor will ask before adding it.

How to install CP Memory in your AI client

Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.

How to install CP Memory in Claude CodeAnthropic's agentic CLI

  1. Add the server

    bash
    claude mcp add cp-memory -- uvx cp-memory-mcp
  2. Verify it's connected

    bash
    claude mcp list
  3. Sharing it with your team?

    Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).

  4. Use it in a session

    Ask Claude to use the tools this server exposes. It discovers them automatically.

What tools does CP Memory expose?

This server runs as a local package. We only query remote servers for their tool list — asking this one would mean executing it, so its tools are listed in the documentation below.

What the code can do

Source analysis currently covers npm packages only. This server ships as a Python package, which needs a different parser.

Before you install

Signals gathered from the source repo and package registry — not a safety verdict.

What it can reach

  • Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
  • Downloads at launch — The package is fetched from its registry each run unless you pin a version.
  • Last commit 1 month ago — Actively maintained.
  • 1 GitHub stars — Very little community usage so far.

Client compatibility

Claude Code: NativeClaude Desktop: NativeCursor: NativeCodex CLI: NativeWindsurf: NativeCline: NativeVS Code: Native

Health score

B · 72

Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated

  • Maintenance30%97%

    Last commit 51 days ago.

  • Adoption20%9%

    1 stars.

  • Transparency20%75%

    3/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✗ discoverable tool list.

  • Provenance15%75%

    Links to its own repository; package linkage unverified.

  • Packaging15%100%

    Publishes a pinned version (1.8.1).

Documentation

Full README

CP Memory

Local-first, governable memory for AI coding agents. Remember project rules across sessions, recall only what matters, and correct bad memory without hiding history.

简体中文 | English


Why CP Memory

For reproducible package, protocol and recall checks, see verification evidence and limits.

  • Local first: memory stays in ~/.cp-memory/memory.db by default.
  • Governable: inspect, review, correct, scope, or retire memory instead of silently overwriting it.
  • MCP-ready, Codex-enhanced: the stdio MCP server is the portable baseline; the Codex plugin adds Skills and lifecycle Hooks.

Quick Start — Portable MCP

With Python 3.10+ and `uv` installed, any stdio MCP client can start CP Memory with:

text
uvx cp-memory-mcp

The public package passed a clean-cache MCP handshake with all 40 tools and a write/search/correct flow. See MCP client setup for Codex, Claude Code, Cursor, VS Code, and Gemini CLI examples.

For the enhanced Codex integration with lifecycle Hooks and Skills, install the plugin:

powershell
codex plugin marketplace add CJhuochai/cp-memory
codex plugin add cp-memory@cp-memory

Restart Codex after installation and approve the lifecycle Hooks if prompted.

Excerpt — the full document is on GitHub.

Maintain CP Memory? Add a badge to your README

Shows its health grade, and links readers to install steps for every client.

markdown
[![CP Memory on MCP Skills Hub](https://mcp-skills-hub.vercel.app/badge/io-github-cjhuochai-cp-memory)](https://mcp-skills-hub.vercel.app/mcps/io-github-cjhuochai-cp-memory)

Catalog data refreshed . Something wrong? Report it.