# iai-mcp-memory-server

The iai-mcp-memory-server skill guides you through setting up a local MCP server that stores conversations and retrieves relevant context from earlier sessions. Use it when an assistant needs continuity across work sessions.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 216 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/iai-mcp-memory-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/iai-mcp-memory-server

## What it does

The skill walks through configuring iai-mcp, a local memory server for AI coding assistants. It stores conversation turns and searches them by meaning. Hooks can capture session activity and bring relevant memories into a new session. Stored data stays on the machine and is encrypted.

Setup instructions cover the server, its Claude Code connection, and capture hooks. Installing the server requires Python 3.11 or 3.12 and Node.js 18 or later; the embedding model download is about 130 MB. The Node.js requirement matters when connecting the MCP server. The skill also covers commands for checking the daemon, querying stored memories, and changing the embedding model.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/iai-mcp-memory-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/iai-mcp-memory-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/iai-mcp-memory-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/iai-mcp-memory-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/iai-mcp-memory-server
```

2. **Manually: put the files in place**
- File: `.github/skills/iai-mcp-memory-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/iai-mcp-memory-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/iai-mcp-memory-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/iai-mcp-memory-server/SKILL.md

## When to use it
- carry conversation context across assistant sessions
- search past discussions by meaning
- capture session activity with hooks
- check the memory daemon and store
- rebuild graph indexes or switch embedding models

## Example prompts
- Help me install the iai-mcp-memory-server skill for Claude Code.
- Set up Claude Code to connect to iai-mcp and install the capture hooks.
- How can I check the daemon and search for our earlier error-handling discussion?

## Similar
- [deep-agents-memory](https://affpapa.org/en/nevibecode/skills/deep-agents-memory.md) — skill · 20000 installs
- [memory-safety-patterns](https://affpapa.org/en/nevibecode/skills/memory-safety-patterns.md) — skill · 11746 installs
- [memory-management](https://affpapa.org/en/nevibecode/skills/memory-management.md) — skill · 7800 installs
- [memory-discipline](https://affpapa.org/en/nevibecode/skills/memory-discipline.md) — skill · 4900 installs
- [memory-leak-debugging](https://affpapa.org/en/nevibecode/skills/memory-leak-debugging.md) — skill · 3700 installs
- [trader-memory-core](https://affpapa.org/en/nevibecode/skills/trader-memory-core.md) — skill · 3700 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
