# IHMT Memory

IHMT Memory keeps decisions, preferences, and project details in local text files for agents to retrieve in later sessions. Use it when you want to stop repeating context.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 38
- Author: gonzaroman
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gonzaroman/IHMT-MEMORY
- Updated: 2026-10-15
- HTML: https://affpapa.org/en/nevibecode/mcp/ihmt-memory

## What it does

The server stores long-term memory as a tree of plain files on your machine. An agent can look up past decisions and their reasons, environment details, preferences, or corrections, then save information likely to matter later. Multiple agents can use the same memory folder.

Claude Code is officially supported, and the project has also been tested with Codex. For a `uvx` setup in Claude Code, run either command in the FAQ. Installation needs internet access; the project also lists Python 3.10 or newer and `git` as requirements. Windows has not been tested by the project, so setup there may need extra care.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `IHMT_HOME` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env IHMT_HOME=<IHMT_HOME> --transport stdio ihmt-memory -- uvx ihmt-memory
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>

### Codex

**Platform CLI**
```bash
codex mcp add ihmt-memory --env IHMT_HOME=<IHMT_HOME> -- uvx ihmt-memory
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ihmt-memory": {
            "command": "uvx",
            "args": [
                "ihmt-memory"
            ],
            "env": {
                "IHMT_HOME": "<IHMT_HOME>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ihmt-memory": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "ihmt-memory"
            ],
            "env": {
                "IHMT_HOME": "<IHMT_HOME>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e IHMT_HOME=<IHMT_HOME> ihmt-memory uvx ihmt-memory
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>

## When to use it
- carry a project decision into later agent sessions
- avoid repeating environment details to an agent
- retrieve an earlier correction or preference
- share one memory folder across connected agents

## Example prompts
- Remember that this project's staging environment runs PostgreSQL 17.
- Find the saved reason for this architecture choice and show me the relevant memory.
- I changed an environment setting; save the new detail and link it to the earlier version.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
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