iai-mcp-memory-server — Claude Code skill: memory and setup
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.
no license 216 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a claude-codeWhat iai-mcp-memory-server 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.
What it helps with
- 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 for the agent
- 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?
How to install iai-mcp-memory-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a claude-code2Manually: put the files in place
~/.claude/skills/iai-mcp-memory-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/iai-mcp-memory-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a codex2Manually: put the files in place
.agents/skills/iai-mcp-memory-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a cursor2Manually: put the files in place
.cursor/skills/iai-mcp-memory-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/iai-mcp-memory-server2Manually: put the files in place
.github/skills/iai-mcp-memory-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/iai-mcp-memory-serverManually: put the files in place
.devin/skills/iai-mcp-memory-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about iai-mcp-memory-server
How do I install iai-mcp-memory-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill iai-mcp-memory-server -a claude-code. The skill file is at ~/.claude/skills/iai-mcp-memory-server/SKILL.md.
What does iai-mcp-memory-server do?
It guides setup of a local MCP memory server that stores conversation turns, finds relevant context through semantic search, and can capture sessions with hooks.
What does the iai-mcp server need to run?
The setup requires Python 3.11 or 3.12 and Node.js 18 or later. It also downloads an embedding model of about 130 MB.