# Share files from Codex

> Connect Floppy to the Codex CLI with three lines of config: Codex uploads files as short links and tells you who opened them.

Codex builds the thing; Floppy lets it hand the result to a person. Add three lines to your Codex config and it can upload a file, give you a short link, and tell you later who opened it.

## What you can do

- Share a generated report, a CSV or a build artifact as a link
- Send a release note or a changelog to customers with one link each
- Ask which customers opened it

## Set it up

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

   ```
   [mcp_servers.floppy]
   url = "https://fpy.sh/mcp"
   ```
2. Sign in with Google:

   ```
   codex mcp login floppy
   ```
3. Test it. Paste this into your agent:

   ```
   Upload README.md to Floppy and give me the link.
   ```

Stuck? Run codex mcp list to check that floppy is there.

## Things to ask

- "Upload README.md to Floppy and give me the link."
- "Upload out/report.csv to Floppy and make a link for each of these customers."
- "Who opened the report link this week?"

## FAQ

### How do I check it's connected?

Run codex mcp list and check that floppy is there. Sign in with codex mcp login floppy, or set bearer_token_env_var to use a key.

### Can Codex upload without an account?

Yes, if it can run commands: curl -T deck.pdf https://fpy.sh/api/drop/deck.pdf returns a share link, an agent key and a claim link for you.

### Can Codex tell me who opened the file?

Yes. Ask who opened a link and it calls get_link_analytics or who_viewed_since: who opened it, which pages they read, for how long, and where they stopped. Bots and email scanners are filtered out.

### Are the files safe?

Every upload is scanned for malware before anyone else can open it. Programs and installers are blocked, and uploaded HTML and SVG are always downloaded, never shown as a web page.

## Other agents

- [Share files from Claude Code](https://fpy.sh/agents/claude-code) ([Markdown](https://fpy.sh/agents/claude-code.md))
- [Share files from Claude](https://fpy.sh/agents/claude) ([Markdown](https://fpy.sh/agents/claude.md))
- [Share files from ChatGPT](https://fpy.sh/agents/chatgpt) ([Markdown](https://fpy.sh/agents/chatgpt.md))
- [Share files from Cursor](https://fpy.sh/agents/cursor) ([Markdown](https://fpy.sh/agents/cursor.md))
- [Share files from VS Code and GitHub Copilot](https://fpy.sh/agents/vs-code) ([Markdown](https://fpy.sh/agents/vs-code.md))
- [A file sharing MCP server](https://fpy.sh/agents/mcp) ([Markdown](https://fpy.sh/agents/mcp.md))

Full agent docs: https://fpy.sh/docs/agents · Everything for LLMs: https://fpy.sh/llms.txt