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

# Email intelligence

> What happens to every message that lands in your mailbox — classification into five categories, to-do detection, summaries, the Morning Brief, and Gmail mirroring.

Every message that arrives in your Langmail mailbox is processed on arrival — whether it came in natively over SMTP or was synced from a connected Gmail account. The results are stored as standard mailbox keywords, so humans see them in webmail and agents can filter by them over MCP.

## The categories

Each message is classified into one of five categories; the orthogonal `todo` flag comes on top (next section). All six values are accepted by the [`search_emails`](/reference/mcp/search-emails) `keywords` filter:

| Value          | What lands here                                                                  |
| -------------- | -------------------------------------------------------------------------------- |
| `direct`       | Personal emails from individuals and direct conversations                        |
| `receipt`      | Order confirmations, shipping updates, delivery notifications, purchase receipts |
| `newsletter`   | Regular updates, news digests, curated content                                   |
| `notification` | Security alerts, terms updates, service notifications                            |
| `promotional`  | Marketing emails, sales pitches, discount offers                                 |
| `todo`         | Messages flagged as requiring action — see below                                 |

Categories are stored on the message as mailbox keywords (`$label:receipt` and so on). In tool results they appear on the `tags:` line; in webmail they show as labels and are searchable.

## To-do detection

Orthogonally to its category, each message is checked for whether it needs explicit action from you — a deadline, a payment, a form, a confirmation. Those messages get the `todo` keyword on top of their category, which makes *"what needs my attention?"* a one-call query for an agent:

```json Tool call — search_emails theme={null}
{ "keywords": ["todo"] }
```

## Summaries and the Morning Brief

Each processed message also gets a short generated summary. Once a day, the Morning Brief email delivers your open to-dos and the categories you opted into — in the language you choose — so the default way to consume a busy inbox is one email, not fifty. You configure the brief (categories, language) in the [Langmail app](https://app.langmail.me).

If you choose the clean-inbox style, handled messages are auto-archived after classification, keeping the inbox itself down to what matters.

## Connected Gmail accounts

You can connect one or more Gmail accounts to the same Langmail user. Their mail is synced in — live updates plus historical backfill — and processed by the same pipeline. State flows back too: a to-do appears in Gmail as a `Todo` label, and archiving in Langmail archives in Gmail, whether the change came from an agent, MCP, or webmail. Mirroring is on by default and can be disabled per account.

<Note>
  Agents see one unified mailbox: synced Gmail messages and native `@langmail.me` mail are searched by the same tools with the same filters.
</Note>