# ChainMemory

> ChainMemory is a freemium MCP server for knowledge and memory. Portable project memory for AI agents, anchored with verifiable hashes. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Chrome extension
- **Website:** https://chainmemory.ai
- **Repository:** https://github.com/chaelynet/chainmemory-mcp
- **MCP Registry name:** io.github.chaelynet/chainmemory
- **Categories:** knowledge and memory, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Memory is organised as a Project Brain: decisions, milestones, risks, priorities, constraints and open questions for each project. Rather than loading everything, `get_project_brief` builds plain text within a character budget (default 7,000), listing what changed since the last read, open risks, active priorities and recent decisions. A task mode narrows the brief to one priority. Briefs are safe to paste into chats, since IP addresses, ports, server paths and security rules are replaced with `[withheld]`.

Version 2.10.0 adds an optional blind vault. With a 12-word BIP-39 phrase set locally, sealed memories are encrypted on your machine and their search vector is computed there, so searches send a vector instead of text. The phrase never leaves the machine and cannot be recovered. A full-detail brief needs an explicit environment flag and the owner's key, and each such request is logged.

An API key is required for every tool except sealing. The service also offers a Chrome extension and a REST API, and the code is MIT licensed.

## Features

- **Project Brain state:** Tracks decisions, priorities, risks and milestones per project.
- **Budgeted briefs:** Builds a prioritised summary within a set character limit.
- **Blind vault:** Encrypts sealed memories locally with a 12-word phrase.
- **Verifiable fingerprints:** Each state change produces a hash that can be verified later.
- **Cross-model memory:** The same memories work with ChatGPT, Claude, Gemini and Perplexity.
- **Redacted briefs:** Server paths, ports and addresses are withheld by default.

## Good for

- Resume a project in a new chat without re-explaining it
- Move context between Claude and ChatGPT
- Prove what a project's state was at an earlier point
- Keep sensitive notes encrypted on your own machine

## Install

### Claude Code (Terminal)

```sh
claude mcp add chainmemory --env CHAINMEMORY_API_KEY='<CHAINMEMORY_API_KEY>' --env CHAINMEMORY_SEED_PHRASE='<CHAINMEMORY_SEED_PHRASE>' --env AICHAIN_KEY='<AICHAIN_KEY>' -- npx -y chainmemory-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<CHAINMEMORY_API_KEY>",
        "CHAINMEMORY_SEED_PHRASE": "<CHAINMEMORY_SEED_PHRASE>",
        "AICHAIN_KEY": "<AICHAIN_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<CHAINMEMORY_API_KEY>",
        "CHAINMEMORY_SEED_PHRASE": "<CHAINMEMORY_SEED_PHRASE>",
        "AICHAIN_KEY": "<AICHAIN_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "chainmemory": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<CHAINMEMORY_API_KEY>",
        "CHAINMEMORY_SEED_PHRASE": "<CHAINMEMORY_SEED_PHRASE>",
        "AICHAIN_KEY": "<AICHAIN_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<CHAINMEMORY_API_KEY>",
        "CHAINMEMORY_SEED_PHRASE": "<CHAINMEMORY_SEED_PHRASE>",
        "AICHAIN_KEY": "<AICHAIN_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "chainmemory": {
      "command": "npx",
      "args": [
        "-y",
        "chainmemory-mcp"
      ],
      "env": {
        "CHAINMEMORY_API_KEY": "<CHAINMEMORY_API_KEY>",
        "CHAINMEMORY_SEED_PHRASE": "<CHAINMEMORY_SEED_PHRASE>",
        "AICHAIN_KEY": "<AICHAIN_KEY>"
      }
    }
  }
}
```

## Tools

- `get_project_brief`: Plain-text project summary within a character budget
- `get_project_state`: Full project state
- `update_project_state`: Update project state with a new verifiable fingerprint
- `save_memory`: Save a memory linked to a project
- `search_memories`: Search memories by content, tags, project or date
- `inject_context`: Inject relevant context into a conversation
- `verify_state_hash`: Verify a past state against its hash
- `chainmemory_seal`: Seal a memory
- `chainmemory_new_seed`: Generate a 12-word seed phrase

## FAQ

### Is an API key required?

Yes, for every tool except chainmemory_seal; keys come from the project's faucet site.

### Can I use more than one model?

Yes. The Chrome extension covers ChatGPT, Claude, Gemini and Perplexity, and the MCP server works with MCP clients such as Claude Desktop and Claude Code.

### How are plans priced?

Free, Starter, Pro and Team tiers differ by monthly memories, injects, projects and retention; prices appear in USD, paid today in USDT.

### Can the seed phrase be recovered?

No. The README says it never leaves your machine and cannot be recovered.

### Is ChainMemory free?

ChainMemory has a free plan, with paid plans for more usage or features.

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

Run this command in your terminal: claude mcp add chainmemory --env CHAINMEMORY_API_KEY='<CHAINMEMORY_API_KEY>' --env CHAINMEMORY_SEED_PHRASE='<CHAINMEMORY_SEED_PHRASE>' --env AICHAIN_KEY='<AICHAIN_KEY>' -- npx -y chainmemory-mcp

### What are the best alternatives to ChainMemory?

The closest alternatives to ChainMemory 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/chainmemory
