# Mail

Como funciona a exportação do Mail, de conectar a resolver problemas.

## Conectar

Clique em “Conectar” ao lado do Mail na tela Início do Exporter (ele fica em “Mais N apps” até você conectá-lo) e depois em “Abrir Pasta do Mail”. O painel abre em `~/Library/Mail`: selecione essa própria pasta. Depois escolha para onde vão os arquivos e clique em “Usar esta pasta”.

O Exporter lê os e-mails que o Mail guarda no seu Mac pela pasta que você autorizou. Ele não pede permissão de e-mail, nem conta, nem Acesso Total ao Disco.

## Escolher os e-mails

A página de seleção tem duas abas, e um e-mail sincroniza quando as duas o marcam.

- “Tipos”: as abas do próprio Mail. “Principal”, “Transações”, “Atualizações”, “Promoções”, e “Não classificados pelo Mail” para o resto. “Atualizações” e “Promoções” começam desmarcadas.
- “Contas”: cada conta pelo endereço, com as caixas de correio dentro. “Rascunhos” e “Lixo” começam desmarcados.

E-mails apagados, spam e lixo eletrônico nunca sincronizam, seja o que for que estiver marcado. O número acima da lista é o que as duas abas deixam juntas.

## Onde ficam os arquivos

Um arquivo Markdown por e-mail, com o nome do dia, do assunto e um número: `2026-09-28 Your order has shipped 491560.md`. Uma pasta logo dentro da sua pasta pessoal, como `~/Documents`, ganha uma pasta `mail-export` dentro dela; uma mais funda é usada como está.

“Organizar”, em “Opções…” no cartão, define as pastas:

- “Por data”: `2026/09/`, uma pasta por ano e mês
- “Por conta”: uma pasta por conta, depois o ano
- “Por tipo”: `primary/`, `transactions/`, `updates/`, `promotions/`, `unsorted/`, depois o ano

Mudar “Organizar” move cada arquivo na próxima sincronização. Nada fica no lugar antigo.

## O arquivo

O front matter traz `from`, `to`, a `mailbox`, `read`, `flagged` quando o e-mail está sinalizado, a `account` e o `kind`, com `source_url` abrindo o e-mail no Mail. Depois, o assunto como título e o corpo como Markdown: títulos, listas, tabelas e links. Os anexos ficam no Mail. Um e-mail cujo corpo o Mail nunca baixou diz isso no seu arquivo.

## Grátis e desbloqueado

Seus 1.000 e-mails mais recentes são exportados e continuam sincronizando grátis. “Desbloquear o Mail” é uma compra única: depois dela, clique em “Sincronizar agora” e o resto do que está marcado sincroniza. Uma primeira sincronização de uma caixa grande que você interrompe ao sair continua de onde parou.

## Sincronização

Enquanto o Exporter está aberto, ele observa o índice do Mail, e os e-mails novos viram arquivos sozinhos. “Sincronizar agora” a roda manualmente; “Ressincronização Completa” grava cada arquivo de novo.

## Linha de comando

`exporter sync --source mail` sincroniza o Mail como o “Sincronizar agora” do cartão. `exporter export --source mail --dest <folder>` grava os e-mails numa pasta autorizada no cartão Linha de Comando e não mexe na sincronização do próprio cartão. Veja [a linha de comando](https://exporter.dev/docs/cli).

## Problemas e soluções

- A página de seleção não mostra e-mails: selecione a própria `~/Library/Mail` no painel, não uma pasta dentro dela. Desconecte e conecte de novo para ter o painel de volta.
- Falta uma conta: uma conta sem nenhum e-mail para gravar (uma caixa de saída vazia, por exemplo) não aparece na lista.
- Um arquivo diz que o corpo não foi baixado: o Mail só tem os cabeçalhos. Abra o e-mail uma vez no Mail e a próxima sincronização grava o corpo.

## Related

- [Mail](https://exporter.dev/pt-br/mail): Cada e-mail como arquivo Markdown
- [Mensagens](https://exporter.dev/pt-br/docs/messages): Conversas, mídia, campos e soluções
- [Servidor MCP](https://exporter.dev/pt-br/docs/mcp): Conecte o Claude e outros agentes

---

human version: https://exporter.dev/pt-br/docs/mail
every page: https://exporter.dev/llms.txt