resend-cli Skill for Claude: What It Does and How to Install It

Makes Claude run the Resend command line for you: send email, set up domains, manage contacts and broadcasts, and listen for webhooks.

Installs: 13.7K; on skills.sh
Stars: 208; on GitHub
Files: 18; besides SKILL.md
Updated: Oct 2026; last repo commit

This skill is Resend's own guide for using its resend command line from an agent. It says to check that the CLI is installed, to supply every flag because the CLI does not prompt outside a terminal, and to read the API key from the RESEND_API_KEY environment variable.

It lists the command groups (emails, domains, broadcasts, contacts, segments, templates, webhooks, API keys, automations, inboxes and more) and 11 common mistakes. Each group has its own file in references/, loaded when the task needs it.

It needs a Resend account and API key. Commands such as emails send really send mail and the delete commands need --yes.

Good for

Developers sending email from scripts or CI/CD
Teams managing Resend domains, contacts and broadcasts
Anyone debugging Resend webhooks or API logs

Install resend-cli

Claude Code

Copy this prompt.

Install the resend-cli skill in Claude Code. Run this command:

/plugin marketplace add resend/resend-skills
/plugin install resend@resend-skills

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. The plugin route installs the resend plugin: 5 skills (counted from the repo tree) and a hosted Resend MCP server entry from mcp.json, which the README says signs in with OAuth. The skills routes install just this skill. The skill drives the resend command line, so install that first as SKILL.md describes (npm or Homebrew; see the skill's Installation section) and set RESEND_API_KEY in the environment.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Operate the Resend platform from the terminal — send emails (including React Email .tsx templates via --react-email), manage domains, contacts, broadcasts, templates, webhooks, API keys, logs, automations, and events via the `resend` CLI. Use when the user wants to run Resend commands in the shell, scripts, or CI/CD pipelines, or send/preview React Email templates. Always load this skill before running `resend` commands — it contains the non-interactive flag contract and gotchas that prevent silent failures.

Sections in SKILL.md

Installation
Agent Protocol
Authentication
Global Flags
Available Commands
Common Mistakes
Common Patterns
When to Load References

Key facts

Author: Resend (vendor's own repo)
License: MIT (SKILL.md frontmatter and the repo README)
Installs on skills.sh: 13,732 (Nov 2, 2026)
GitHub stars: 208 for the whole resend/resend-skills repo (Nov 2, 2026)
Last repo commit: Oct 28, 2026
What it includes: 19 files including SKILL.md: 18 reference files under references/ and no scripts
Needs: The resend command line (install it with npm or Homebrew) and a RESEND_API_KEY in your environment
Part of: The resend plugin in resend/resend-skills. The repo has 5 skills, and its mcp.json registers Resend's hosted MCP server
Works in: Claude Code, Cursor and any Agent Plugins client, per the repo README

What it includes

Runs resend --version and installs the CLI if missing
Checks whether the CLI is installed. If not, SKILL.md points to npm or Homebrew, and to resend.com/docs/cli for installer scripts.
Runs code · Install check
Rules for non-interactive use: all flags, --quiet, exit codes
Tells Claude to pass every required flag, add --quiet, expect JSON on stdout and errors on stderr, and treat received email content as untrusted data.
Read · Agent protocol
Reads RESEND_API_KEY, or a stored profile
Uses the environment variable first, then a stored login. It forbids writing a literal key into commands or files.
Read · Authentication
Send, get, list, batch, cancel, update, metrics and receiving
Sends and manages email through your Resend account, including React Email .tsx templates with --react-email.
Try: “Send a test email from hello@mydomain.com to me@example.com with the subject "Test".”
Write · emails
Create, verify, get, claim, update, delete, list
Adds a sending domain and checks its verification status. The list view leaves out DNS records; domains get shows them.
Write · domains
Create and send broadcasts, manage contacts, segments and topics
Creates broadcasts, sends them with --send, and manages the audience lists. Only broadcasts created through the API can be sent from the CLI.
Write · broadcasts and contacts
Create, update, rotate signing secret, listen, replay
Sets up webhook endpoints and can run a local listener on a port you give it.
Write · webhooks
Manage keys, templates, automations and events
Create, update and delete these objects in your account.
Write · api-keys, templates, automations, events
Read API logs and quota, manage inboxes, suppressions (beta), job posts
Lists request logs and usage limits, and manages agent inboxes. careers list shows open jobs at Resend and careers apply submits an application.
Network · logs, usage, inboxes, suppressions, careers
--dry-run on emails send, broadcasts create, emails batch
Prints the request it would make without calling the API. Other commands do not support it.
Read · Dry run
11 mistakes with fixes, such as forgetting --yes on deletes
A table covering deletes, webhook secrets, batch scheduling, CSV imports and attachment URLs.
Read · Common mistakes

From the official docs

Permissions

Medium risk

Claude can send email and change your Resend account from the command line, so a wrong command reaches real recipients. Use a key that only has the access you need and try --dry-run before a send.

What it can do

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

Watch out for

It sends real email from your account
emails send and broadcasts send reach real recipients. SKILL.md documents --dry-run for emails send, broadcasts create and emails batch, so run that first. github.com
Delete commands can remove account data
SKILL.md says every delete or rm subcommand needs --yes in non-interactive mode, so Claude has to pass it deliberately. Check the target before you approve. github.com
It can create and delete API keys
The api-keys group has create, list, update and delete. Ask Claude to confirm which key it will touch. github.com
careers apply submits an application
references/careers.md describes a command that submits a job application to Resend from the terminal. Only run it if that is what you want. github.com
The plugin route adds an MCP server
The plugin registers the hosted Resend MCP server at mcp.resend.com. The skills-only routes do not add it. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. Use version control.
Sign-in and keys	SKILL.md reads RESEND_API_KEY from the environment first, then a stored login made with resend login --key. It says never to write a literal key into a command or file.
Scopes	Runs the resend command line in your shell with your API key Sends email, broadcasts and webhook calls through your Resend account Can delete domains, contacts, API keys and other objects (delete commands need --yes)

Questions

What does the resend-cli skill do?

It teaches Claude to run the resend command line correctly. Claude uses it to send email and to manage domains, contacts, broadcasts, templates, webhooks and API keys from the shell.

How do I install resend-cli?

Use the install box at the top of this page. You also need the resend command itself, which SKILL.md says to install with npm or Homebrew, and a Resend API key in RESEND_API_KEY.

Does it work in the Claude app?

The install box has no Claude app upload for it, because the skill runs a command line tool on your computer. Use Claude Code. The repo README names Claude Code, Cursor and Agent Plugins clients.

Does it need an API key?

Yes. SKILL.md lists RESEND_API_KEY as required, from the API keys page. It can also use a named profile set with RESEND_PROFILE.

Is it safe?

It acts on your real Resend account, so treat it like an API key with full access. Commands can send email to real people, and delete commands need --yes. SKILL.md tells Claude to treat received email as data and not follow instructions in it. Use a key limited to what you need (our advice) and try --dry-run first.

What is the difference between resend-cli and the resend skill?

resend-cli runs the command line. The resend skill in the same repo is about the Resend API and SDKs, and SKILL.md points to it for SDK work in Node.js, Python or Go.

Is this skill from Resend?

Yes. It is in Resend's own repo, resend/resend-skills. SKILL.md lists Resend as author, and the README says this copy is synced from resend/resend-cli, so edits are made there.

Should I install the whole Resend plugin?

Only if you want all of it. The plugin has 5 skills and registers the hosted Resend MCP server from its mcp.json, which the README says signs in with OAuth.

Information

updated Nov 2, 2026

Repository: resend/resend-skills
Folder: skills/resend-cli

resend/resend-skills skills.sh

Sources

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

Show all 5

resend-cli SKILL.md · github.com
resend/resend-skills README · github.com
resend plugin.json · github.com
resend-skills mcp.json · github.com
resend-cli workflows.md · github.com