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 command wires Hutch in as an MCP server, and OAuth handles auth. The Codex CLI, IDE extension, and ChatGPT desktop app share the same config.
Install
Fastest: paste this into Codex and it sets itself up. You approve the sign-in in your browser.
Connect Hutch (hutchdb.com) to Codex as an MCP server.
- URL: https://app.hutchdb.com/api/mcp
- Transport: remote streamable HTTP
- Auth: OAuth (no API key). I'll approve in the browser.
How to do it in Codex:
- Run: codex mcp add hutch --url https://app.hutchdb.com/api/mcp (it detects OAuth and starts the login).
- If hutch is already configured, run codex mcp login hutch.
1. Add the server for my user account, not just this project, so it works everywhere.
2. Start the OAuth login, or tell me exactly what to click if you can't start it yourself.
3. Tell me if I need to restart or reload you. Then call hutch_list_collections to confirm it works.Or set it up by hand:
01Step 1. Connect
Run this in your terminal:
codex mcp add hutch --url https://app.hutchdb.com/api/mcpCodex detects OAuth and opens a browser window. Sign in with GitHub or Google and approve.
02Step 2. Authenticate (if needed)
If the browser didn't open, run:
codex mcp login hutchPrefer editing config? Add [mcp_servers.hutch] with url = "https://app.hutchdb.com/api/mcp" to ~/.codex/config.toml, then run the command above.
03Step 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."