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.

Heads up (draft): the @pileless/mcp-server package is being published to npm. Until it's live, run it from source (note in step 2). These instructions are the final shape.

1. Get your Pileless API key

Grab a workspace API key (ak_…) from Pileless → Settings → API keys, or run:

npx @pileless/mcp-server login

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-server"]
env = { PILELESS_API_KEY = "ak_…" }

Running from source (until the npm package is live): build the Pileless MCP server, then set command = "node" and args = ["/abs/path/to/dist/index.js"].

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.

Next: bring your own cloud →