Dev & Engineering

Cloudflare Email Service Skill

Guides agents through implementing transactional email sending, receiving, and routing on Cloudflare.

52/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 3.1k
Last updated
13d ago
License
Apache-2.0
cloudflareemail-sendingemail-routingworkers
+3transactional-emailrest-apimcp

What does this skill do, and when should you use it?

This skill covers Cloudflare Email Service, including Email Sending and Email Routing. It guides developers through sending transactional email with a Workers binding or REST API, as well as processing inbound mail. The material includes Agents SDK email handling, Wrangler setup, MCP tools, and SPF, DKIM, and DMARC guidance. It is retrieval-first because the service launched in 2025 and is still evolving quickly.

It checks whether a domain is enabled for Email Sending, looks for a send_email binding in wrangler.jsonc, and identifies postal-mime as a receiving and parsing dependency. It provides implementation paths and examples for Workers bindings, the REST API, Email Routing, the Agents SDK, Wrangler CLI, and MCP. It also covers HTML and plain-text messages, attachments, custom headers, forwarding, replying, and common configuration mistakes.

Good fit
  • A developer adding welcome, notification, or registration emails to a Cloudflare Worker.
  • A developer building a Cloudflare Agents SDK agent that receives email and handles it with onEmail() or replyToEmail().
  • A developer sending mail from an external Node.js, Python, or Go application through the Cloudflare Email Sending REST API.
  • A team configuring Email Sending or Email Routing with Wrangler or the Cloudflare Dashboard.
  • A developer troubleshooting SPF, DKIM, DMARC, bounces, suppressions, or spam-folder placement.

How do you install this skill?

Before you use it
  • Sending and forwarding email have real external side effects; execution should require confirmation and clearly scope recipients, senders, credential permissions, and recovery options.
  • Do not transfer the remote-development configuration directly to production or real recipients; the document states that remote=true actually sends email.
  • Cloudflare API fields, Wrangler commands, error codes, and GraphQL schemas may change; verify them against the original specifications before implementation.
  • Inbound mail, subjects, bodies, attachments, and analytics events require data minimization, access control, and redaction.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
  • MCP Server
Install first
  • Node.js
  • Wrangler CLI
  • postal-mime for receiving and parsing emails

The skill is part of the cloudflare/skills collection. An Agent Skills-compatible client can install the collection with npx skills add https://github.com/cloudflare/skills; alternatively, clone the repository and copy skills/cloudflare-email-service into the client’s skill directory. The README lists directories for Claude Code, Cursor, OpenCode, OpenAI Codex, and Pi, but does not document a separate installation command for this skill alone.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/cloudflare/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/skills/cloudflare-email-service" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Add email to my Cloudflare Worker
  • Configure Cloudflare Email Routing and process inbound mail.

Ask a supported coding agent for a concrete task such as “Add email to my Cloudflare Worker” or “Configure Cloudflare Email Routing and process inbound mail.” Before sending, verify the domain and binding; run npx wrangler email sending list, and if needed run npx wrangler email sending enable yourdomain.com.

What are this skill's strengths and limitations?

Pros
  • Covers Workers bindings, the REST API, Email Routing, and Agents SDK email workflows.
  • Includes directly usable wrangler.jsonc, TypeScript, and REST API examples.
  • Clearly distinguishes Workers and REST API field names and failure modes.
  • Includes setup, deliverability, and SPF, DKIM, and DMARC guidance.
Limitations
  • It explicitly requires retrieval from official sources, so it should not be treated as permanently current product documentation.
  • It is for transactional email, not newsletters, marketing campaigns, or bulk promotional sending.
  • The source provides no test suite, version pinning, or complete standalone installation procedure.
  • Some workflows require Cloudflare domain configuration, Wrangler, network access, or MCP tools.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Cloudflare Email Service Skill this page 52 · Use with care ★ 3.1k 13d ago Apache-2.0
Xberg API Server & MCP Protocol Integration 52 · Use with care ★ 9.4k 12d ago MIT
Gemini Enterprise Managed Agents ✓ Google · Official 40 · Not recommended ★ 21k 12d ago Apache-2.0
Cloudflare Durable Objects Builder 48 · Use with care ★ 3.1k 13d ago Apache-2.0
Cloudflare Agents SDK Builder 49 · Use with care ★ 3.1k 13d ago Apache-2.0

The skill distinguishes Cloudflare Email Service from dedicated marketing email platforms: Cloudflare Email Service is positioned for transactional email, while newsletters and marketing campaigns should use a dedicated marketing platform.

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
52/ 100 5-point scale 2.6 / 5
The upstream repository has new commits since this review. The score still applies to the reviewed revision shown and may not cover the latest changes.
1Trust14 / 25 · 2.8/5

The document discloses API tokens, domain verification, sensitive email content, recipient verification, suppression lists, restricted sender bindings, and a human-review pattern, while warning against hardcoded credentials. However, sending, forwarding, and suppression changes lack explicit user confirmation, a least-privilege permission matrix, and rollback procedures; examples also expose full recipient, subject, and event data. The deduction for incomplete confirmation, isolation, and recovery yields 14/25.

2Reliability8 / 20 · 2.0/5

The skill clearly separates Workers bindings, REST, routing, agents, and error codes, and documents several failure responses. However, there are no committed tests or reproducible execution records for key paths; several behaviors and fields depend on external documentation, and claims such as forwarding failing silently are not internally verified. Edge-case coverage is limited. Static calibration supports 8/20.

3Adaptability10 / 15 · 3.3/5

The skill identifies concrete scenarios for sending, receiving, agents, CLI/MCP, and deliverability, and distinguishes transactional from marketing email. However, its trigger scope is broad, inputs and outputs are not systematically specified, non-fit cases are incomplete, Chinese-language guidance is absent, and mainland-China reachability is not addressed. Core retrieval depends on Cloudflare, npm, and GitHub services that may be difficult to reach from mainland China. Score: 10/15.

4Convention9 / 15 · 3.0/5

The main document uses progressive disclosure through scenario-specific references and includes setup notes, examples, limits, and common mistakes. The repository supplies an Apache-2.0 license, and the skill warns that its content may become stale and directs users to source material. It lacks skill-level versioning, a changelog, named maintenance ownership, and a clear update path, with incomplete dependency governance and troubleshooting coverage. Score: 9/15.

5Effectiveness7 / 15 · 2.3/5

Examples cover Workers, REST, routing, attachments, deliverability monitoring, and Agent email handling, so accurate content could provide a directly usable implementation starting point. Static review cannot confirm that commands, API fields, or examples execute, and there is no evidence comparing the result with manual alternatives. Static calibration therefore limits the score to 7/15.

6Verifiability4 / 10 · 2.0/5

The skill names auditable Cloudflare documentation, the REST API specification, Workers types, and the Agents SDK as source-of-truth materials, and repeatedly instructs retrieval from originals. However, it provides no committed tests, CI results covering the skill, or independent reproduction records; evidence is primarily author-written guidance and examples. Score: 4/10.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 70215303d44a Review evidence[1][2][3][4][5][6][7][8][9]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does the Workers binding require API keys?
The source says the Workers binding does not require API keys, but the sending domain must first be enabled and onboarded for Email Sending.
Can applications outside Workers send email?
Yes. External Node.js, Python, and Go applications can use the REST API with a Bearer token.
What commonly causes sending or routing failures?
Typical causes include an un onboarded domain, incorrect REST API field names, hardcoded API tokens, or an unverified forwarding destination.
Is this suitable for marketing email?
No. The skill explicitly scopes Email Service to transactional email and recommends a dedicated platform for marketing campaigns.

More skills from this repository

All from cloudflare/skills

Dev & Engineering

Cloudflare Durable Objects Builder

Build and review stateful coordination applications on Cloudflare.

★ 3.1k FS 48 Use with care 13d ago
Dev & Engineering

Cloudflare Agents SDK Builder

Guides developers in building stateful, real-time, and durable AI agents on Cloudflare Workers.

★ 3.1k FS 49 Use with care 13d ago
Dev & Engineering

Workers Production Review

Write and review production-ready Workers code using current Cloudflare guidance.

★ 3.1k FS 57 Use with care 13d ago
Dev & Engineering

Turnstile End-to-End Setup

Adds Cloudflare Turnstile to existing forms with frontend embedding, backend verification, and validation.

★ 3.1k FS 54 Use with care 13d ago
Dev & Engineering

Cloudflare Wrangler Deployment Guide

Helps agents reliably build, develop, deploy, and manage Cloudflare Workers with Wrangler.

★ 3.1k FS 49 Use with care 13d ago
Dev & Engineering

Cloudflare Sandbox Builder

Guides agents in building secure, isolated code execution on Cloudflare Workers.

★ 3.1k FS 46 Use with care 13d ago
Dev & Engineering

Cloudflare Platform Builder

Helps agents research and build applications on Cloudflare.

★ 3.1k FS 45 Not recommended 13d ago
Automation & Ops

Cloudflare One Migration Planner

Turns Zscaler, Palo Alto, legacy VPN, SWG, or SASE migrations into verifiable Cloudflare One plans.

★ 3.1k FS 58 Recommended 13d ago
Automation & Ops

Cloudflare One Zero Trust Advisor

Guides agents through designing, configuring, and troubleshooting Cloudflare One.

★ 3.1k FS 55 Use with care 13d ago
Dev & Engineering

Web Performance Auditor

Use Chrome DevTools MCP to diagnose page-load performance, Core Web Vitals, and accessibility gaps.

★ 3.1k FS 43 Not recommended 13d ago

Related skills