Aippocampus
by Sapientropiccommunityv0.3.3
5
AIppocampus is a local-first memory and continuity system for AI agents that preserves original conversation source, lets agents search/reopen past snippets, and builds source-backed clean-source, timeline, and recall artifacts across projects and devices. It also exposes public CLI, MCP, sync, and plugin surfaces for working with registered agent history.
From the registry: Local-first, source-backed continuity for AI agents via stdio MCP.
Install & configure
Prerequisites
- requiredInstall Python 3.12 or newerAIppocampus supports Python 3.12 and newer.
- requiredInstall uv/uvxThe README recommends the packaged CLI via `uvx aippocampus ...`, which requires uv/uvx to be installed.
- optionalOptional: set up Codex local history/homeFor useful memory search/recall, AIppocampus is designed to work with local Codex conversation history. The README references `CODEX_HOME` and onboarding Codex history after user consent.
$ export CODEX_HOME="<your-codex-home>" - optionalOptional: DeepSeek API keyRequired only if you enable external DeepSeek-compatible semantic/frontier features.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `aippocampus` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Python 3.12 or newer** — AIppocampus supports Python 3.12 and newer.
- **Install uv/uvx** — The README recommends the packaged CLI via `uvx aippocampus ...`, which requires uv/uvx to be installed.
Optional prerequisites:
- Optional: set up Codex local history/home — For useful memory search/recall, AIppocampus is designed to work with local Codex conversation history. The README references `CODEX_HOME` and onboarding Codex history after user consent. Run: `export CODEX_HOME="<your-codex-home>"`
- Optional: DeepSeek API key — Required only if you enable external DeepSeek-compatible semantic/frontier features.
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["aippocampus","mcp"]
- optional environment variables:
- `CODEX_HOME`: Path to the Codex home directory used for local conversation history and registry-related workflows. (example: `<your-codex-home>`)
- `AIPPOCAMPUS_REGISTRY_DIR`: Override path for the AIppocampus registry directory. (example: `<your-registry-dir>`)
- `AIPPOCAMPUS_HOME`: Base AIppocampus home directory; registry may be stored under this path. (example: `<your-aippocampus-home>`)
- `AIPPOCAMPUS_VAULT`: Path to a vault or notes location used by AIppocampus. (example: `<your-vault-path>`)
- `AIPPOCAMPUS_STYLE_SOURCE`: Optional style source configuration. (example: `<your-style-source>`)
- `AIPPOCAMPUS_SCRIPT_SOURCE`: Optional script source configuration. (example: `<your-script-source>`)
- `AIPPOCAMPUS_SITE_MARK`: Optional site mark setting. (example: `<your-site-mark>`)
- `AIPPOCAMPUS_SITE_TITLE`: Optional site title setting. (example: `<your-site-title>`)
- `AIPPOCAMPUS_SEMANTIC_GATE`: Optional semantic gate configuration. (example: `<your-semantic-gate>`)
- `DEEPSEEK_API_KEY`: API key for optional DeepSeek-backed semantic/frontier features. (example: `<your-deepseek-api-key>`)
Note: The README identifies a local stdio MCP server. The simplest portable install path is the packaged CLI: `uvx aippocampus mcp`. The README also shows a script entrypoint (`python ./skills/aippocampus/scripts/aippocampus_mcp_server.py`) and mentions a Windows executable, but the packaged `uvx` path is preferred. No client wrapper JSON is included here.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README identifies a local stdio MCP server. The simplest portable install path is the packaged CLI: `uvx aippocampus mcp`. The README also shows a script entrypoint (`python ./skills/aippocampus/scripts/aippocampus_mcp_server.py`) and mentions a Windows executable, but the packaged `uvx` path is preferred. No client wrapper JSON is included here.
Tools (4)
health
Checks the current workspace/runtime health.
search
Searches old conversation memory and registered source-backed snippets.
onboard
Registers and indexes local Codex conversation history for later recall.
mcp
Provides MCP access to the server’s memory and continuity functions.
Environment variables
AIPPOCAMPUS_REGISTRY_DIRrequiredPrimary directory for storing generated recall artifacts and registry data.AIPPOCAMPUS_HOMErequiredBase directory used for the registry fallback path under AIPPOCAMPUS_HOME/registry.CODEX_HOMErequiredUsed to locate the legacy fallback registry path and Codex skills/install location.DEEPSEEK_API_KEYrequiredRequired when using the optional DeepSeek-compatible frontier extraction write mode.Prerequisites
- • Python 3.12
Packages
aippocampus
pypiv0.3.3transport: stdio
Details
- Language
- Python
- License
- Apache-2.0
- Released
- Jun 15, 2026
- Last commit
- Jul 8, 2026
- Registry name
- io.github.Sapientropic/aippocampus
Related Servers
Claude Flow
AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.
65.5k
Codebase Memory Mcp
Persistent codebase knowledge graph. Survives session restarts and context compaction.
33.8k
Serena
A powerful toolkit for coding, providing semantic retrieval and editing capabilities.
26.7k