Akhrot Codex MCP

A zero-dependency MCP connector that gives OpenAI Codex (and Claude Desktop) access to Akhrot GML long-term memory.

It's a small stdio ⇆ streamable-HTTP bridge that proxies an MCP client to the remote memory server at https://akhrots.com/mcp, plus the installers that wire it into Codex in one step.

Codex ──stdio MCP──▶ bridge (node) ──HTTPS + Bearer──▶ https://akhrots.com/mcp

Features

Zero dependencies, Node 18+. The whole bridge is one file (bridge/index.js).
Trigger-phrase gating — memory tools fire only when the user says "use akhrots memory…", never on bare "remember"/"save" or proactively.
Fast tools only — exposes recall/remember/forget/list_memories (~1s) and hides the heavy 30–45s pipeline tools (query, ingest, …). GML_ALLOW_SLOW=1 re-exposes them.
Instant handshake — answers the host's initialize immediately and connects to the remote in the background, so a slow/cold server never makes the client drop the connector.
Pre-warm — pokes the remote on launch (bounded to 12s) to soften cold-start latency.
No static tokens — the per-user token is injected at install time and passed via env; it is never committed or baked into this repo.

Install into Codex

1. One-step installer (recommended)

Windows: install-akhrot-codex.cmd — double-click.
macOS: install-akhrot-codex.command — right-click → Open (Gatekeeper).

Writes the bridge to ~/.codex/akhrot-memory/index.js and merges into ~/.codex/config.toml:

toml [mcp_servers.akhrot-memory] command = "node" args = ["/abs/path/to/.codex/akhrot-memory/index.js"] env = { GML_MCP_URL = "https://akhrots.com/mcp", GML_TOKEN = "<token>" }

Restart Codex, then: use akhrots memory to remember …

2. Codex plugin

bash codex plugin marketplace add ./plugin codex plugin add akhrot-memory@akhrot

3. Manual

Paste the [mcp_servers.akhrot-memory] block into ~/.codex/config.toml, or use Settings → MCP servers → Connect to a custom MCP (STDIO: node + bridge path + env vars).

Run the install page locally

```bash node server.mjs

open http://localhost:8787/app

```

Configuration

| Var | Default | Meaning | |---|---|---| | GML_MCP_URL | https://akhrots.com/mcp | Remote MCP endpoint | | GML_TOKEN | (required) | Short-lived per-user relay token | | GML_TRIGGER | use akhrots memory | The phrase that unlocks the tools | | GML_ALLOW_SLOW | (unset) | 1 to also expose the slow pipeline tools |

Repo layout

bridge/index.js the MCP stdio<->HTTP bridge (publishable as `akhrots-mcp`) server.mjs dev install-page server + per-download installer/plugin generators app.html the "Connect your AI" page plugin/ Codex plugin template

License

MIT — see LICENSE.

MCP Servers