https://github.com/webbertakken/email-worker

Lightweight tool to process emails directly from Cloudflare
https://github.com/webbertakken/email-worker

cloudflare-workers discord email email-forwarding email-worker

Last synced: about 1 year ago
JSON representation

Lightweight tool to process emails directly from Cloudflare

• Host: GitHub
• URL: https://github.com/webbertakken/email-worker
• Owner: webbertakken
• License: mit
• Created: 2023-02-22T19:04:37.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-09T17:00:08.000Z (about 1 year ago)
• Last Synced: 2025-04-10T01:09:50.587Z (about 1 year ago)
• Topics: cloudflare-workers, discord, email, email-forwarding, email-worker
• Language: TypeScript
• Homepage:
• Size: 383 KB
• Stars: 62
• Watchers: 2
• Forks: 13
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

          
# Email worker · [![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/webbertakken/email-worker/blob/main/LICENSE) [![codecov](https://codecov.io/gh/webbertakken/email-worker/branch/main/graph/badge.svg?token=vWf0M5qX20)](https://codecov.io/gh/webbertakken/email-worker) [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/webbertakken/email-worker/blob/main/CONTRIBUTING.md)

Send emails to Cloudflare and forward them to different channels using an email worker.

## Setup

#### Prerequisites

- Cloudflare [account](https://dash.cloudflare.com/sign-up) (free)

- [Volta](https://volta.sh/) installed (for managing correct Node and Yarn versions)

- Wrangler installed [globally](https://developers.cloudflare.com/workers/wrangler/install-and-update/#install-wrangler-globally)

#### Install dependencies

```bash

yarn install

```

#### Deploy the worker

```bash

yarn deploy

```

#### Set up a webhook

- Right-click on a Discord channel then click `Edit Channel`, then `Integrations`.

- Create a webhook, then copy the URL.

- Add this url to your secrets:

```bash

wrangler secret put DISCORD_WEBHOOK_URL

```

You should see something like this

```console

🌀 Creating the secret for the Worker "email-worker"

✨ Success! Uploaded secret DISCORD_WEBHOOK_URL

```

#### Set up a route

- Go to your [zone's Email Workers settings](https://dash.cloudflare.com/?to=/:account).

- Click the zone (e.g. `example.com`), then `Email`, `Email Routing`.

- On the `Email Workers` tab, register an email route.

[![Register an email route](./assets/email-routing.png)](./assets/email-routing.png)

#### Verify

- Send an email to the email address you registered.

- Check the channel you registered the webhook to.

## Tips

- Change the `name` field in `wrangler.toml` to deploy a separate worker with a separate secret (e.g. with a separate webhook for a test channel). 

## License

This package is [MIT](./LICENSE) licensed.

#### Sub licenses

- [`mat-sz/letterparser`](https://github.com/mat-sz/letterparser): [BSD-3 Clause Clear](https://github.com/mat-sz/letterparser/blob/master/LICENSE)