claude-code-el-sendgrid
SendGrid inbound email event source for the el plugin. Receive and process incoming emails via SendGrid Inbound Parse webhook as background
Open source Open in the app JSON README (API)
About
SendGrid inbound email event source for the el plugin. Receive and process incoming emails via SendGrid Inbound Parse webhook as background events in Claude Code. When an email arrives, it fires a task notification with sender, subject, and body — letting your agent react to emails without polling. Requires the el event listener plugin and a SendGrid account with Inbound Parse configured.
Details
- Kind
- Plugins
- Topic
- Communication
- Publisher
- mividtim
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-02-10T02:18:12Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
mividtim/claude-code-el-sendgrid/claude-code-el-sendgrid
README
# claude-code-el-sendgrid
Community event source for [claude-code-event-listeners](https://github.com/mividtim/claude-code-event-listeners) that receives inbound emails via SendGrid's Inbound Parse webhook.
## Install
```bash
# From the marketplace (recommended — auto-discovers, pulls in el as dependency)
claude plugin marketplace add mividtim/claude-code-el-sendgrid
claude plugin install el-sendgrid
# Or manually register the source
git clone https://github.com/mividtim/claude-code-el-sendgrid.git
/el:register ./claude-code-el-sendgrid/sources.d/sendgrid.sh
```
## Prerequisites
- **SendGrid account** with Inbound Parse configured
- **ngrok** (or similar) forwarding to localhost on the listener port
- SendGrid Inbound Parse webhook URL pointed at the ngrok tunnel
### SendGrid Inbound Parse Setup
1. Go to SendGrid > Settings > Inbound Parse
2. Add a hostname and URL (your ngrok URL)
3. Check "POST the raw, full MIME message" if you want full headers
4. Set up an MX record for your domain pointing to `mx.sendgrid.net`
See [SendGrid docs](https://docs.sendgrid.com/for-developers/parsing-email/setting-up-the-inbound-parse-webhook) for details.
## Usage
```
/el:listen sendgrid
```
Or with explicit port:
```
/el:listen sendgrid 9998
```
### Environment variables
| Variable | Default | Description |
|----------|---------|-------------|
| `SENDGRID_WATERMARK_FILE` | `/tmp/sendgrid-webhook-watermark` | File storing the last processed message ID |
## Output Format
```json
{"from": "jason@example.com", "to": "ghostwriter@yourdomain.com", "subject": "Re: Chapter draft", "text": "Proceed to the 1940s.", "message_id": "<abc123@mail.gmail.com>"}
```
## Requirements
- [claude-code-event-listeners](https://github.com/mividtim/claude-code-event-listeners) plugin installed
- Python 3
- ngrok or similar tunnel (running separately)
## License
MIT