Use Foldr with OpenAI Codex CLI (MCP)
Codex CLI is OpenAI's lightweight terminal agent that runs the o-series and GPT-5-class models locally against your repo. Codex CLI supports MCP servers for external tools alongside its shell and file-edit primitives. Connecting Foldr lets Codex share generated artifacts without leaving the agent loop.
Installation
Add the Foldr MCP server to OpenAI Codex CLI with the snippet below. Replace fs_live_... with an API key from foldr.space/developers.
codex mcp add foldr \ --env FOLDR_API_KEY=fs_live_... \ -- npx -y @foldr/mcp-server
Setup tip: Or edit ~/.codex/config.toml and add an [mcp_servers.foldr] block.
Official OpenAI Codex CLI MCP docsWhat You Can Do
- Upload any file from OpenAI Codex CLI to Foldr and get a shareable URL back in the same turn
- Shorten long URLs to foldr.space/s/... links without leaving OpenAI Codex CLI
- Create or update a Foldr bio page from a OpenAI Codex CLI conversation
- Generate a hosted Foldr form and paste the submission URL into your reply
- Hand off build artifacts, screenshots, and logs to a URL without leaving your editor
OpenAI Codex CLI + Foldr FAQ
How do I install the Foldr MCP server in OpenAI Codex CLI?
Open OpenAI Codex CLI's MCP configuration (the CLI) and paste the config block shown above. Set FOLDR_API_KEY to a key you create at foldr.space/api-keys. Restart OpenAI Codex CLI if it doesn't hot-reload.
Which Foldr plan do I need to use the MCP integration with OpenAI Codex CLI?
The Foldr MCP server is available on every paid plan (Pro from $5/mo and Developer tier for API-heavy usage). The free tier can generate temporary 7-day links; for permanent storage, a Pro plan or Foldr Space is required.
I set the key but OpenAI Codex CLI says the Foldr tool isn't available — what's wrong?
The two most common issues: (1) OpenAI Codex CLI wasn't restarted after editing the config — most MCP hosts need a restart to pick up new servers. (2) Your API key is missing the `mcp:invoke` scope. Regenerate a key at foldr.space/api-keys with full scope and retry.
Can OpenAI Codex CLI upload files directly to Foldr, or just generate URLs?
OpenAI Codex CLI can do both. The MCP server exposes tools for `upload_file` (takes a local path or base64 blob), `shorten_url`, and `create_bio_page`. Any file OpenAI Codex CLI can read from disk can be uploaded.
Is the Foldr MCP integration with OpenAI Codex CLI production-ready?
Foldr's MCP server is stable and used in production. OpenAI Codex CLI's MCP support is currently in public beta — suitable for day-to-day use. We pin to stable SDK versions and publish changelog entries for every breaking change.
Related MCP Integrations
Connect OpenAI Codex CLI to Foldr in under a minute
Grab an API key, paste the snippet above into OpenAI Codex CLI's MCP config, and your agent can upload files and share URLs immediately.
Get your Foldr API key