Hutch + C 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.

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