SMTP2GO Agent Skills

An Agent Skill is a packaged set of instructions that an AI agent loads on demand to perform a specific task. SMTP2GO publishes Agent Skills that call the SMTP2GO API directly, with no server or bridge process in between. They live in the public repository github.com/smtp2go-oss/skills.

📘

Installed from GitHub for now

The catalog is new and still growing. Skills install directly from the GitHub repository and are not yet published to a skill registry.

MCP or Skills?

Both let an AI agent work with SMTP2GO, in different ways:

• MCP connects your agent to a live server that exposes the whole API dynamically — listing, searching, and executing any endpoint.
• Skills give your agent a packaged, task-specific capability that calls the REST API directly, with nothing running in between.

Reach for MCP when you want broad, interactive API access. Reach for a Skill when you want a focused action, such as sending email, that just works.

Prerequisites

• Node.js 18+ (used by the skills CLI to install skills)
• An SMTP2GO API key, exported for your session:

export SMTP2GO_API_KEY="your-smtp2go-api-key"

The smtp2go-send-email skill needs an API key with the /email/send permission. /single_sender_emails/view and /allowed_senders/view are useful if you want the agent to check verified senders first.

Install

Install a skill with the skills CLI:

npx skills add smtp2go-oss/skills --skill smtp2go-send-email --global --agent codex

• Omit --agent to choose your agent interactively.
• Omit --global to install for the current project only.

For full install and usage details, see the repository: github.com/smtp2go-oss/skills.

Available skills

Calling a skill

Once a skill is installed, restart your agent so it picks up the skill. You can then invoke it explicitly by name, or describe the task and let the agent match it to the skill automatically. Make sure SMTP2GO_API_KEY is available in the environment the agent runs in.

🚧

Ensure your sender address is valid

The from address must be a verified sender in your SMTP2GO account, or sending will fail.

Codex

In the Codex text interface, type a dollar sign ($) followed by the skill name:

$smtp2go-send-email

Codex runs the skill's instructions — including any scripts or plugins it configures — and sends the email through the SMTP2GO API. Add details in the same message to fill in the send, for example:

$smtp2go-send-email send a test email from [email protected] to [email protected] with the subject "Hello from SMTP2GO"

Codex can also apply the skill automatically when your request matches its description.

Claude Code

In Claude Code, type a forward slash (/) followed by the skill name:

/smtp2go-send-email

Claude loads the skill and follows its instructions. It can also apply the skill automatically when your request matches its description — for example, "Use SMTP2GO to send a test email to [email protected] from a verified sender."

Install the skill for Claude Code with --agent claude-code (the install example above uses --agent codex).

Authentication & security

Create and scope an API key at app.smtp2go.com/sending/apikeys.

Do not commit real API keys to project files. Prefer environment variables or a secret manager, and use a dedicated, narrowly scoped key for skills.