# emailthing

> A web app for receiving and sending your emails!

Latest version **0.0.10** (published 2026-02-11) · 0 weekly downloads

## Install

```sh
npm install emailthing
pnpm add emailthing
yarn add emailthing
bun add emailthing
```

Provides the command `emailthing`.

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; has provenance; high maintenance score.

Warnings: low downloads; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.0.10 |
| Published | 2026-02-11 |
| First published | 2024-04-16 |
| Weekly downloads | 0 |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 14.7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 333 |
| Author | RiskyMH |
| Maintainers | riskymh |
| Keywords | cli, sdk, email |

## Links

- npm: https://www.npmjs.com/package/emailthing
- Repository: https://github.com/RiskyMH/EmailThing
- Homepage: https://emailthing.app/home
- Issues: https://github.com/RiskyMH/EmailThing/issues
- npm.io page: https://npm.io/package/emailthing

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 0.0.10 (latest) — 2026-02-11
- 0.0.9 — 2026-01-26
- 0.0.8 — 2025-11-16
- 0.0.7 — 2025-11-16
- 0.0.6 — 2025-09-26
- 0.0.5 — 2025-09-26
- 0.0.4 — 2024-10-04
- 0.0.3 — 2024-04-20
- 0.0.2 — 2024-04-19
- 0.0.1 — 2024-04-19
- 0.0.0-claim — 2024-04-16

## README

# EmailThing

> This is a package with the SDK for [EmailThing](https://emailthing.app/home) to use with the API, and also has a CLI version so you can view your emails and send them from the terminal.

**NOTE:** This is v0 still and can contain breaking changes.

## SDK

JavaScript library for the [EmailThing API](https://emailthing.app/docs/api).

### Setup

First, you need to get an API key, which is available in the EmailThing mailbox config page.

```js
import { EmailThing } from 'emailthing';
const emailthing = new EmailThing('et__aaaaaaaaaaaaaaaaaaaaaaaaaaaaaabbbbbb');
```

### Usage

Send your first email:

```js
await emailthing.send({
  from: 'you@example.com',
  to: ['user@gmail.com'],
  subject: 'hello world',
  text: 'it works!',
});
```

You can also use more advanced features:

```js
await emailthing.send({
  from: 'Me <you@example.com>',
  to: [
    'Friend <user@gmail.com',
    'Better Friend <user@emailthing.xyz>'
  ],
  cc: ['Me <you@example.com>'],
  bcc: ['Me <you@example.com>'],
  reply_to: 'Everyone <you@example.com>',
  subject: 'hello world',
  text: 'it works!',
  html: '<h1>it works!</h1>',
  headers: {
    'X-Entity-Ref-ID': '23456789',
  },
  config: {
    // no config options right now
  },
});
```

## CLI

An in-progress visual terminal interface for the [EmailThing](https://emailthing.app/home) site.

Modes provided by [`@emailthing/cli`](https://www.npmjs.com/package/@emailthing/cli):
* Normal interactive: navigate mailboxes, read and compose emails from your terminal
* Agent mode: let your agent interact with your emails via command line

> Note: This requires [Bun](https://bun.com/) as its runtime.

```sh
$ bunx emailthing
$ bunx @emailthing/cli
# Welcome to EmailThing CLI!
# <interactive terminal UI starts here>

$ bunx @emailthing/cli agent list # see your email list
$ bunx @emailthing/cli agent email id12345 # see that email
```

---
_Source: https://npm.io/package/emailthing · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._