Hutch+CCodex

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.

Install

~/hutch/install-codexSETUP

01Step 1. Configure

Add this block to ~/.codex/config.toml:

SHELL
[mcp_servers.hutch]
url = "https://app.hutchdb.com/api/mcp"

02Step 2. Authenticate

Then run:

SHELL
codex mcp login hutch

A browser window opens for OAuth. Sign in with GitHub or Google and approve.

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."