- name
- cloudflare-mail-reader
- description
- Read one mailbox's messages or a paginated mail list from a Cloudflare temporary mail system through the
/admin/mailsadmin API and return structured results. Use when Codex is asked to fetch or read emails through the backend instead of opening the web UI, including requests such as "read mails for t2@suilong.online", "show the latest 20 emails", "export mailbox messages", or "use the Cloudflare mail admin API to fetch messages".
Cloudflare Mail Reader
Use this skill to read mailbox messages through https://mail-api.suilong.online/admin/mails.
Follow This Workflow
- Collect or infer
address,limit, andoffset. - Default
limitto20andoffsetto0when the user does not specify them. - Never store real credentials in the skill. Pass runtime credentials with CLI flags or environment variables.
- Run scripts/read_mails.py to fetch and normalize the response.
- The normalized result includes
verification_codewhen a code can be extracted from subject/text/html content. - Return the script's JSON output directly unless the user asks for a reformatted summary.
- Use
--output-format csvand optionally--output-file <path>when the user asks for exportable results. - Preserve the normalized statuses:
ok,auth_error,error. - Use
--include-rawonly when the user explicitly wants the full original payload for debugging.
Run The Script
Read one mailbox:
C:\Users\sl\AppData\Local\Python\bin\python.exe scripts/read_mails.py `
--address t2@suilong.online `
--limit 20 `
--offset 0 `
--admin-auth $env:CLOUDFLARE_MAIL_ADMIN_AUTHRead recent mails without an address filter:
C:\Users\sl\AppData\Local\Python\bin\python.exe scripts/read_mails.py `
--limit 20 `
--offset 0 `
--admin-auth $env:CLOUDFLARE_MAIL_ADMIN_AUTHExport messages as CSV:
C:\Users\sl\AppData\Local\Python\bin\python.exe scripts/read_mails.py `
--address t2@suilong.online `
--limit 20 `
--output-format csv `
--output-file .\mail-results.csv `
--admin-auth $env:CLOUDFLARE_MAIL_ADMIN_AUTHRuntime Credentials
Prefer environment variables for secrets:
CLOUDFLARE_MAIL_ADMIN_AUTHCLOUDFLARE_MAIL_BEARER_TOKENCLOUDFLARE_MAIL_CUSTOM_AUTHCLOUDFLARE_MAIL_FINGERPRINTCLOUDFLARE_MAIL_LANGCLOUDFLARE_MAIL_USER_TOKENCLOUDFLARE_MAIL_MAILS_API_URL
Read More Only When Needed
- Read references/api.md for the endpoint contract and normalization rules.
- Read references/examples.md for example prompts and outputs.