Connect Codex
Codex talks to Pileless through the same MCP server as Claude Code — you just register it in Codex's config. About two minutes.
1. Get your Pileless API key
Grab a workspace API key (ak_…) from Pileless → Settings → API keys — create one and copy it (it's shown only once).
Prefer a file over an env var? Put the key in
~/.pileless/config.json as {"api_key": "ak_…"} — the MCP server reads it automatically.2. Register the MCP server in Codex
Codex reads MCP servers from ~/.codex/config.toml. Add a Pileless entry:
[mcp_servers.pileless]
command = "npx"
args = ["-y", "@pileless/mcp"]
env = { PILELESS_API_KEY = "ak_…" }3. Verify
Restart Codex. It should list pileless among its MCP tools. Ask it: "create a test pile to approve and send me the link." A pile should appear in your inbox.
4. Use it
Add the piling rule to your Codex agent instructions (e.g. AGENTS.md) so it routes decisions to you instead of guessing:
When you're about to send/post/publish/commit, or you have 2+ options
for me to choose from, create a Pileless pile and wait for my decision.This is the right home for an autonomous agent: Codex can run long, unattended jobs and queue every human call into one inbox you clear later.