Codex is OpenAI's terminal coding agent. Like every agent, it forgets what happened five sessions ago: decisions, open bugs, threads you meant to pick back up. Hutch is the durable layer underneath.
One TOML block in ~/.codex/config.toml wires Hutch in as an MCP server. OAuth handles auth.
Install
Step 1. Configure
Add this block to ~/.codex/config.toml:
[mcp_servers.hutch]
url = "https://hutchdb.com/api/mcp"Step 2. Authenticate
Then run:
codex mcp login hutchA browser window opens for OAuth. Sign in with GitHub or Google and approve.
Step 3. Try it
In a Codex session:
- “Store this article in my Hutch reading-list collection.”
- “Save the bugs we just discussed to a "tickets" collection in Hutch.”
- “What collections do I have in Hutch?”
- “Find my notes about caching in Hutch.”