cloudflare-email-service Skill for Claude: Send and Receive Email on Cloudflare

cloudflare-email-service helps your coding assistant send and route email with Cloudflare Email Service, from a Worker, the REST API or the wrangler CLI.

Installs: 108K; on skills.sh
Stars: 3.2K; on GitHub
Files: 6; besides SKILL.md
Updated: Oct 2026; last repo commit

cloudflare-email-service tells the assistant to check current Cloudflare docs before writing email code, since the product is new. It starts with prerequisites: is the domain enabled for sending, is the send_email binding in the wrangler config, and is postal-mime installed for receiving. Then it follows a table that picks the path: Worker binding, Agents SDK, REST API, coding-agent tools or inbound routing.

It also lists eleven common mistakes, such as a missing binding, an unverified domain or the wrong field names between the REST API and Workers. It is for transactional email, not newsletters. It bundles no scripts.

Good for

Developers sending transactional email from Cloudflare Workers
Teams handling inbound email with Email Routing
Anyone fixing delivery problems such as SPF, DKIM or bounces

Install cloudflare-email-service

Claude Code

Copy this prompt.

Install the cloudflare-email-service skill in Claude Code. Run this command:

/plugin marketplace add cloudflare/skills
/plugin install cloudflare@cloudflare

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. The README says the plugin installs the Cloudflare guidance and the main Cloudflare MCP server, and it brings every skill in the repo. The skills CLI route installs only this skill.

From the project README. Source.

What's in the skill

When it loads

Implement or troubleshoot Cloudflare Email Sending and Email Routing integrations and their delivery configuration.

Sections in SKILL.md

Retrieval Sources
FIRST: Check Prerequisites
What Do You Need?
Sending Workflow
Common Mistakes
References
Skill feedback

Key facts

Author: cloudflare (GitHub)
Repository: cloudflare/skills, folder skills/cloudflare-email-service
Installs on skills.sh: 107,950 (as of 2026-11-02)
Repo stars: 3,244 (whole repository, as of 2026-11-02)
License: Apache-2.0
Last repo commit: 2026-10-31
Files in the skill folder: 7 files: SKILL.md and 5 reference guides plus the feedback guide
skills.sh audits: Gen Agent Trust Hub: pass, Socket: pass, Snyk: warn

What it includes

Is the domain enabled, binding set, postal-mime installed
Runs `npx wrangler email sending list` and checks the wrangler config and `npm ls postal-mime`.
Runs code · Check prerequisites
Table of what you want to do and which guide to read
Workers binding, Agents SDK email, REST API, coding-agent tools, inbound routing, setup and deliverability.
Pick a path
Prefer the Workers binding; REST for outside apps
Reads the sending or REST guide before writing code, covering recipients, attachments, limits and errors.
Write · Sending workflow
Eleven pitfalls with fixes
Covers the send_email binding, domain onboarding, single-use raw streams, HTML-only mail, bulk sends and field naming differences.
Common mistakes
Sending, REST API, routing, CLI and MCP, deliverability
Opens the guide that matches your situation.
Read · Reference guides
Enable a domain for sending or routing with wrangler
The cli-and-mcp.md guide lists wrangler commands to enable or disable sending and routing for a domain, show the DNS records, manage routing rules and destination addresses, and send mail with `wrangler email sending send`. It also describes using the Cloudflare MCP server to call the Email Service API.
Runs code · Setup commands

From the official docs

Permissions

Medium risk

It can turn on email sending for a domain in your Cloudflare account and send real messages, and if you report bad guidance it may offer to post a public GitHub issue after you approve the text. Confirm each wrangler command and test with addresses you own.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It can enable email on your Cloudflare domain
Setup uses wrangler commands that turn on Email Sending or Routing for a domain on your account. Run them yourself or confirm each one.
It can send real email
The cli-and-mcp.md guide says `wrangler email sending send` and the Email API send real messages, and that `"remote": true` in `wrangler dev` sends real email too. It says to use test addresses you control. SKILL.md warns that bounces from fake addresses hurt your sender reputation.
Keep API tokens out of source code
The skill warns against hardcoding tokens. Use environment variables or Cloudflare secrets.
The plugin route also adds Cloudflare's MCP server
The README says the Claude Code plugin installs the Cloudflare guidance and the main remote Cloudflare MCP server, which gives access to the Cloudflare API and docs. The skills CLI route installs only this skill.
Skill feedback can post a public GitHub issue
A bundled skill-feedback.md tells the assistant what to do if you report wrong or outdated guidance: ask your permission, draft an issue for cloudflare/skills, show you the exact title and body and post only after you answer yes. It uses `gh issue create`, and the issue is public, so check the text for secrets before you approve.

Technical details

Talks to	Cloudflare API and docs
Scopes	Cloudflare API token, if you use the REST API

Questions

What does the cloudflare-email-service skill do?

It helps your assistant implement or troubleshoot Cloudflare Email Sending and Email Routing. It checks the setup, picks the right way to send or receive, and warns about common mistakes.

How do I install cloudflare-email-service?

Use the install box at the top of the page. The plugin route installs every Cloudflare skill plus the Cloudflare MCP server, and the skills CLI route installs only this one.

Does it need an API key?

Not for a Worker, which uses a send_email binding. Sending from an external app through the REST API needs a Bearer token from your Cloudflare account.

Can I use it for newsletters or marketing email?

No. The SKILL.md says Email Service is for transactional email only, and to use a dedicated marketing platform for bulk sends.

Is cloudflare-email-service safe?

The skill is instructions with no scripts, but it does tell the assistant to run wrangler commands that change your Cloudflare account and can send real email, so confirm each one. It also warns to keep tokens out of source code.

How is it different from the agents-sdk skill?

cloudflare-email-service covers Email Sending and Routing, including sending from an agent built with the Agents SDK. agents-sdk covers building the agent itself and has its own email reference file.

Information

updated Nov 2, 2026

Repository: cloudflare/skills
Folder: skills/cloudflare-email-service

cloudflare/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

cloudflare/skills README · github.com
skills.sh listing · skills.sh
cloudflare-email-service SKILL.md · github.com
cloudflare-email-service cli-and-mcp.md · github.com
agents-sdk SKILL.md · github.com
cloudflare-email-service skill-feedback.md · github.com