AIppocampus — Claude Code MCP server: features and setup
AIppocampus lets an agent find earlier decisions and reopen conversation source. It helps when ongoing work needs context from past sessions.
claude mcp add aippocampus -- uvx aippocampusWhat AIppocampus does
The server connects an agent to local conversation memory. It searches the current and registered threads, returns source-backed snippets, and can reopen material for verification. For a vague recollection, start with recall and deepen the result; exact search fits cases where the user remembers the wording.
AIppocampus builds source from supported local Codex records, Claude Code transcripts, and explicit JSONL exports of visible messages. Summaries guide navigation but do not replace the original source. Registering local history requires the user's consent, so an agent should not ingest it without permission.
What it helps with
- Find an earlier decision from a remembered situation
- Reopen a conversation excerpt to verify a claim
- Recover context from a handoff between sessions
- Search registered conversations for an exact phrase
Example prompts for the agent
- Find the decision about keeping the old authorization approach, then open its source.
- Recover the context from the last task handoff and show the source before drawing conclusions.
- Search past conversations for the exact wording about error handling and reopen the match.
How to install AIppocampus
Platform CLI
claude mcp add aippocampus -- uvx aippocampusuvx runs the command named after the package; if the README names another one, use uvx --from aippocampus <command>
Platform CLI
codex mcp add aippocampus -- uvx aippocampusuvx runs the command named after the package; if the README names another one, use uvx --from aippocampus <command>
Config file
{
"mcpServers": {
"aippocampus": {
"command": "uvx",
"args": [
"aippocampus"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from aippocampus <command>
Config file
{
"servers": {
"aippocampus": {
"type": "stdio",
"command": "uvx",
"args": [
"aippocampus"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from aippocampus <command>
Platform CLI
gemini mcp add aippocampus uvx aippocampusuvx runs the command named after the package; if the README names another one, use uvx --from aippocampus <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 AIppocampus
How do I install AIppocampus in Claude Code?
Run claude mcp add aippocampus -- uvx aippocampus. Claude Code will launch the MCP server through uvx.
What does AIppocampus do?
It helps an agent search local conversations and return to their original source. That can restore context around earlier decisions or task handoffs.
Which conversation sources does AIppocampus support?
It can use local Codex records, Claude Code transcripts, and explicit JSONL exports of visible messages. Registering local history requires user consent.
