> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openpawz.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Email

> Pawz can read and send email through your existing accounts using Himalaya, an IMAP/SMTP CLI client.

# Email

Pawz can read and send email through your existing accounts using Himalaya, an IMAP/SMTP CLI client.

## Prerequisites

Install [Himalaya](https://github.com/pimalaya/himalaya):

```bash theme={null}
# macOS
brew install himalaya

# Linux
cargo install himalaya
```

## Configuration

Himalaya uses a TOML config file at `~/.config/himalaya/config.toml`:

```toml theme={null}
[accounts.personal]
email = "you@gmail.com"
display-name = "Your Name"

[accounts.personal.imap]
host = "imap.gmail.com"
port = 993
login = "you@gmail.com"
passwd.cmd = "security find-generic-password -s gmail -w"

[accounts.personal.smtp]
host = "smtp.gmail.com"
port = 465
login = "you@gmail.com"
passwd.cmd = "security find-generic-password -s gmail -w"
```

## Skills setup

Enable the **Email** skill in the **Skills** tab and provide:

| Credential | Example                               |
| ---------- | ------------------------------------- |
| SMTP\_HOST | smtp.gmail.com                        |
| SMTP\_PORT | 465                                   |
| SMTP\_USER | [you@gmail.com](mailto:you@gmail.com) |
| SMTP\_PASS | your app password                     |
| IMAP\_HOST | imap.gmail.com                        |
| IMAP\_USER | [you@gmail.com](mailto:you@gmail.com) |
| IMAP\_PASS | your app password                     |

:::tip
For Gmail, use an [App Password](https://support.google.com/accounts/answer/185833) — not your regular password.
:::

## Agent tools

With the Email skill enabled, agents get:

| Tool         | Approval         | Description                      |
| ------------ | ---------------- | -------------------------------- |
| `email_read` | Auto             | Read inbox, search emails        |
| `email_send` | **HIL required** | Send emails (human must approve) |

## Mail permissions

Each account can have granular permissions:

| Permission | Description             |
| ---------- | ----------------------- |
| `read`     | Allow reading emails    |
| `send`     | Allow sending emails    |
| `delete`   | Allow deleting emails   |
| `manage`   | Allow folder management |

## Provider icons

The mail view auto-detects your provider and shows the appropriate icon:

| Provider | Icon |
| -------- | ---- |
| Gmail    | G    |
| Outlook  | O    |
| Yahoo    | Y    |
| iCloud   | iC   |
| Fastmail | FM   |
| Other    | M    |

## Provider presets

The account setup wizard auto-fills IMAP/SMTP settings for popular providers:

| Provider              | IMAP Server             | IMAP Port | SMTP Server           | SMTP Port | Auth notes                                                                 |
| --------------------- | ----------------------- | --------- | --------------------- | --------- | -------------------------------------------------------------------------- |
| **Gmail**             | `imap.gmail.com`        | 993       | `smtp.gmail.com`      | 465       | Requires [App Password](https://support.google.com/accounts/answer/185833) |
| **Outlook / Hotmail** | `outlook.office365.com` | 993       | `smtp.office365.com`  | 587       | Regular password or App Password with 2FA                                  |
| **Yahoo Mail**        | `imap.mail.yahoo.com`   | 993       | `smtp.mail.yahoo.com` | 465       | App Password from Yahoo Security settings                                  |
| **iCloud Mail**       | `imap.mail.me.com`      | 993       | `smtp.mail.me.com`    | 587       | App-Specific Password from appleid.apple.com                               |
| **Fastmail**          | `imap.fastmail.com`     | 993       | `smtp.fastmail.com`   | 465       | App Password from Privacy & Security                                       |
| **Custom**            | (manual)                | 993       | (manual)              | 465       | Enter your own IMAP/SMTP details                                           |

:::info
All connections use TLS encryption. Passwords are stored in the **OS keychain** (macOS Keychain / libsecret on Linux), never in plain text files.
:::

## Email filtering and folders

Agents can work with email folders to organize messages:

| Action         | Tool           | Description                                         |
| -------------- | -------------- | --------------------------------------------------- |
| List inbox     | `email_read`   | Fetch emails from INBOX or any named folder         |
| Move to folder | `move_email`   | Move a message to a different folder (e.g. Archive) |
| Delete email   | `delete_email` | Move to trash or permanently delete                 |
| Search         | `email_read`   | Search by subject, sender, or content               |

### Folder support

Himalaya supports standard IMAP folders:

* `INBOX` — default inbox
* `[Gmail]/All Mail` — Gmail archive
* `[Gmail]/Drafts` — drafts folder
* `Sent` / `[Gmail]/Sent Mail` — sent items
* Custom folders created by the user

## Attachment handling

Email attachments are managed through the Himalaya CLI:

* **Reading** — `email_read` retrieves the full message body including inline content
* **Downloading** — the agent can save attachments to the local filesystem via Himalaya commands
* **Sending** — attachments can be included when composing messages through the Himalaya skill

## AI email actions

The mail view includes built-in AI actions for each email. These send a pre-composed prompt to your agent:

| Action            | What the agent does                                      |
| ----------------- | -------------------------------------------------------- |
| **Summarize**     | Generates a concise summary of the email content         |
| **Draft Reply**   | Composes a professional reply based on the email context |
| **Extract Tasks** | Identifies action items and tasks mentioned in the email |

### Compose and reply

The built-in compose modal supports:

* **Reply** — pre-fills the recipient and subject with `Re:` prefix
* **Forward** — pre-fills the subject with `Fwd:` prefix and includes the original message
* **New email** — opens the chat with a compose prompt for the agent to draft and send

:::tip
For AI-composed messages, the agent drafts the email and uses Himalaya to send it. All outgoing email through the `email_send` tool requires **human-in-the-loop (HIL) approval** — you must confirm before any email is actually sent.
:::

## Credential Vault

Email accounts are protected by the Credential Vault with a full audit trail:

* **Permission toggles** — enable/disable read, send, delete, and manage permissions per account
* **Activity log** — every agent email action is logged with timestamps
* **Blocked actions** — attempts to use a disabled permission are logged and denied
* **Revoke access** — instantly remove an account and delete credentials from the device

## Channel integration

Email can also be set up as a channel — see [Channel Routing](/channels/overview) for details.