SEC.00 / INTEGRATION — HUTCH × CODEX
Use Hutch from
Codex.
Give the OpenAI coding agent a place to remember things.
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.
SEC.01 / INSTALL — 3 STEPS
Install
~/hutch/install-codex SETUP
01 Step 1. Configure
Add this block to ~/.codex/config.toml:
SHELL
[mcp_servers.hutch]
url = "https://app.hutchdb.com/api/mcp" 02 Step 2. Authenticate
Then run:
SHELL
codex mcp login hutch A browser window opens for OAuth. Sign in with GitHub or Google and approve.
03 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."
SEC.02 / OTHER CLIENTS — 7 MORE