IHMT Memory — Claude Code MCP server: features and setup
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.
claude mcp add --env IHMT_HOME=<IHMT_HOME> --transport stdio ihmt-memory -- uvx ihmt-memoryWhat IHMT Memory 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.
What it helps with
- 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 for the agent
- 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.
How to install IHMT Memory
Platform CLI
claude mcp add --env IHMT_HOME=<IHMT_HOME> --transport stdio ihmt-memory -- uvx ihmt-memoryReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>
Platform CLI
codex mcp add ihmt-memory --env IHMT_HOME=<IHMT_HOME> -- uvx ihmt-memoryReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
gemini mcp add -e IHMT_HOME=<IHMT_HOME> ihmt-memory uvx ihmt-memoryReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from ihmt-memory <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about IHMT Memory
How do I install IHMT Memory in Claude Code?
Run claude mcp add ihmt-memory -- uvx ihmt-memory. To set the memory directory explicitly, use claude mcp add --env IHMT_HOME=<IHMT_HOME> --transport stdio ihmt-memory -- uvx ihmt-memory.
What does IHMT Memory do?
It keeps an agent's long-term memory in local text files. Connected agents can retrieve shared entries in later sessions.
What does IHMT Memory need to run?
The project lists Python 3.10 or newer, git, and internet access during installation as requirements. Claude Code is officially supported; Windows has not been tested.
