← Back to Skills Marketplace
Sendgrid Skills
by
Vince Lozada
· GitHub ↗
· v1.2.2
1976
Downloads
3
Stars
1
Active Installs
5
Versions
Install in OpenClaw
/install sendgrid-skills
Description
SendGrid email platform integration for sending and receiving emails. Routes to sub-skills for outbound transactional emails (send-email) and receiving via I...
README (SKILL.md)
SendGrid
Overview
SendGrid is an email platform for developers. This skill routes to feature-specific sub-skills.
Sub-Skills
| Feature | Skill | Use When |
|---|---|---|
| Sending emails | send-email |
Transactional emails, notifications, simple sends, dynamic templates |
| Receiving emails | sendgrid-inbound |
Inbound Parse Webhook, MX record setup, parsing incoming email |
Common Setup
API Key
Store in environment variable:
export SENDGRID_API_KEY=SG.xxxxxxxxx
SDK Installation
See send-email skill for installation instructions across supported languages.
When to use SendGrid vs other services
What's your use case?
├─ Transactional emails (receipts, notifications, password resets)
│ └─ SendGrid (send-email) ✅
├─ Marketing campaigns / bulk email
│ └─ Consider SendGrid Marketing Campaigns (outside this skill)
├─ Receiving emails programmatically
│ └─ SendGrid Inbound Parse (sendgrid-inbound) ✅
└─ Simple SMTP relay
└─ SendGrid SMTP (outside this skill)
Resources
Usage Guidance
This package appears coherent for integrating with SendGrid, but review and follow these precautions before installing or running anything: 1) Inspect the included scripts (they're present in the bundle) before executing them; they will read files you point them at and make network requests (to SendGrid and optional webhook URLs). 2) Use an API key with least privilege (Mail Send only) and avoid using long-lived high-privilege keys in shared environments. 3) When verifying inbound webhooks, test against non-production endpoints first — the verify script will POST to whatever HTTPS webhook URL you provide (it has URL validation but still contacts external hosts). 4) Prefer using a dedicated subdomain and verified sender identities when sending/receiving emails. 5) If you plan to allow the agent to invoke this skill autonomously, be comfortable with the agent having the ability to call these scripts and send requests using your SENDGRID_API_KEY; otherwise keep invocation manual. If you want additional assurance, run the scripts in an isolated/test environment and rotate the API key after verification.
Capability Analysis
Type: OpenClaw Skill
Name: sendgrid-skills
Version: 1.2.2
The OpenClaw skill bundle provides SendGrid integration for sending and receiving emails. It demonstrates strong security awareness, including robust input validation in `scripts/verify-inbound-setup.sh` to prevent shell injection and SSRF, and file path validation in `scripts/send-html-email.sh` to prevent arbitrary file reads. Crucially, the documentation (`sendgrid-inbound/SKILL.md`, `sendgrid-inbound/references/best-practices.md`) explicitly warns about protecting against prompt injection when forwarding inbound email content to AI systems. There is no evidence of intentional malicious behavior, data exfiltration, persistence, or malicious prompt injection attempts within the skill's code or instructions.
Capability Assessment
Purpose & Capability
Name/description (SendGrid send/receive) match the declared requirements: SENDGRID_API_KEY and binaries curl, jq, node. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md and included scripts instruct the agent to run local helper scripts that send mail via the SendGrid API and validate inbound webhook/DNS configuration. The scripts accept file paths and webhook URLs and will make network requests (SendGrid API and optional webhook testing). The scripts include input validation (file-extension checks, directory-traversal checks, hostname/url regexes) and the README warns to review scripts before running.
Install Mechanism
Instruction-only skill (no install spec). Scripts are bundled in the repo and will not download arbitrary code; no remote installs or URLs are used. This is the lowest-risk install pattern.
Credentials
Only SENDGRID_API_KEY is required (SENDGRID_FROM is optional). That matches the skill purpose. The skill even recommends scoping the key to Mail Send permissions.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or global agent settings, and is user-invocable. Autonomous invocation is allowed (platform default) but not combined with other privilege escalations.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install sendgrid-skills - After installation, invoke the skill by name or use
/sendgrid-skills - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Security fixes: input validation on scripts, metadata.openclaw.requires block for SENDGRID_API_KEY transparency
v1.2.1
Fixed ClawHub security flag by adding requirements metadata (SENDGRID_API_KEY, binaries)
v1.2.0
Added send-html-email.sh script for HTML email support with proper JSON escaping via jq
v1.1.0
- Added support and documentation for receiving emails using SendGrid Inbound Parse Webhook via the new `sendgrid-inbound` sub-skill.
- Expanded triggers and use-case descriptions for both sending and receiving emails with SendGrid.
- Updated sub-skill documentation to reflect new inbound and outbound capabilities.
- Introduced utility scripts for testing email sending, webhook parsing, and inbound setup.
- Enhanced READMEs to include setup guides, use case clarifications, and integration resources.
v1.0.1
- Added initial SKILL.md documentation for SendGrid skill.
- Describes skill purpose, usage, and available sub-skills for sending emails.
- Includes setup instructions for API key and resource links for further information.
Metadata
Frequently Asked Questions
What is Sendgrid Skills?
SendGrid email platform integration for sending and receiving emails. Routes to sub-skills for outbound transactional emails (send-email) and receiving via I... It is an AI Agent Skill for Claude Code / OpenClaw, with 1976 downloads so far.
How do I install Sendgrid Skills?
Run "/install sendgrid-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Sendgrid Skills free?
Yes, Sendgrid Skills is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Sendgrid Skills support?
Sendgrid Skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Sendgrid Skills?
It is built and maintained by Vince Lozada (@vince-winkintel); the current version is v1.2.2.
More Skills