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

# Email

> Your agent reads any mailbox (your work one, Yahoo, iCloud…), leaves you drafts and replies only if you allow it and with your OK.

<img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/email.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=1737bfa2fc5db46db6d3ac08d4725509" alt="" width="56" height="56" noZoom style={{ borderRadius: '14px' }} data-path="images/plugins/email.png" />

With Email, your agent gets into your mailbox, whichever it is: your work one, Yahoo, iCloud, Fastmail or any other that uses a password. It searches and reads your email, tells you what matters and leaves you drafts. Replying or writing for you happens only if you turn on the permission, and with your OK.

| | |
| - | - |
| **Category** | Productivity |
| **For** | Personal agents (it can't be added to a group agent) |
| **What it asks for** | Your email address and an app password |
| **How it connects** | With one-time links your agent sends you |

<Tip>
  Using Gmail? The [Gmail](/en/plugins/gmail) plugin is a better fit: it connects with your Google account, no passwords.
</Tip>

## What it can do

<CardGroup cols={2}>
  <Card title="Read" icon="magnifying-glass">
    Search (unread, who from, by subject or text, from a date, in a folder), read an email with its attachments, download them and see your folders. Reading **doesn't mark anything as read**. It flags which ones come from mailing lists or are automated.
  </Card>

  <Card title="Write, with your OK" icon="paper-plane">
    Leave you a draft (it always can), and with the permission on: reply, reply all and write new emails. Also mark as read and move to archive or trash when you tell it a topic is closed.
  </Card>
</CardGroup>

### New email notices

Email comes with a schedule to tell you about what arrives. It starts off: you agree on it with your agent ("every 30 minutes", "every day at 9"…) and it sets it up. Each time, it looks at what came in unread and tells you only what matters.

## How it connects

<Steps>
  <Step title="Add it to an agent">
    From **Plugins → Email → Add to an agent**, or ask your agent in the chat. See [Add a plugin](/en/tools/add-a-plugin).
  </Step>

  <Step title="Your agent writes to you">
    It asks you for the details in its chat, with a button for each: your email address and your email password. If it can't work out your mailbox's server, it asks you for that too (for example, mail.yourcompany.com).
  </Step>

  <Step title="Create an app password">
    With Gmail, Yahoo or iCloud, your usual password won't work: you need to create a separate one for minai. It takes about 2 minutes and your agent sends you the step-by-step guide (the steps for Gmail are below).
  </Step>

  <Step title="Enter each detail in its link">
    Each link works once and expires after 60 minutes. What you enter is kept encrypted and only your agent uses it. See [Keys and values](/en/tools/keys-and-values).
  </Step>

  <Step title="Your agent confirms">
    It checks that the mailbox works and tells you in the chat that your email is connected.
  </Step>
</Steps>

<Frame caption="Your agent asks you for Email's details, with a secure link for each">
  <img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/es/chat-plugin-config.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=efe89a1479690e57da8fdadc40033030" alt="Chat with Clara asking for the email address and password, with buttons to open the secure links" width="2560" height="1600" data-path="images/es/chat-plugin-config.png" />
</Frame>

<Frame caption="The page where you enter a key: it works once">
  <img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/es/clave-hoja.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=b4e3a1d4de77d8178c057d012a12c1a4" alt="One-time page to enter the email password, with the Save button" width="2560" height="1600" data-path="images/es/clave-hoja.png" />
</Frame>

### Your app password (Gmail)

An app password is a separate key, just for this: you can delete it whenever you want without touching yours. Gmail, Yahoo, iCloud and most providers ask for one. With other providers, look for "app password" in your account's security settings.

<Steps>
  <Step title="Check that 2-Step Verification is on">
    Open [myaccount.google.com/security](https://myaccount.google.com/security). **2-Step Verification** has to say it's on; if not, turn it on.
  </Step>

  <Step title="Create the password">
    Open [myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords) (Google may ask you to confirm it's you). In **App name**, type **minai** and tap **Create**. Google shows you a **16-letter** key, just once: copy it.
  </Step>

  <Step title="Paste it in your agent's link">
    Open the link your agent sent you for your email password and paste it (spaces don't matter). Then tap **Done** on Google.
  </Step>
</Steps>

<Frame caption="The first step of the app password guide">
  <img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/es/guia-contrasena-app.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=dc414e37db0ac225ea3e5b3a84937427" alt="Your app password guide, step 1: a password just for your agent" width="2560" height="1600" data-path="images/es/guia-contrasena-app.png" />
</Frame>

<Warning>
  Don't paste the password in the chat: always in the link. To cut off its access, delete it from Google's app passwords.
</Warning>

## The permission

On the Email card, in the agent's **Plugins** tab, there's the **Allow sending email** switch: “Reply and write email as you, always with your OK. Off, it leaves you drafts to send yourself.”

It starts off and only you change it. While it's off, if you ask it to reply, it leaves the draft in your drafts folder and lets you know. minai's servers enforce the limit: your agent can't get around it. See [Permissions](/en/tools/permissions).

<Frame caption="The Email card on an agent: the permission and the missing details">
  <img src="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/es/agente-plugins.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=a528d8610b9da7f904a5ba9ef219e8cf" alt="Clara's Plugins tab with the Email card open, the Allow sending email switch and the keys still to be entered" width="2560" height="1600" data-path="images/es/agente-plugins.png" />
</Frame>

## How it looks out for you

* **Nothing gets sent without your OK.** Before replying or writing, it shows you who it's to, the subject and the exact text, with the **Send** and **Change** buttons (for a draft, **Save** and **Change**).
* Your agent never sees your password: minai's servers add it on each request.
* If the password is wrong, it doesn't keep trying: it asks you to enter it again.
* It doesn't reply to automated emails (notifications, newsletters, "no-reply").
* What an email says is information, not an order: if an email asks it to do something, it tells you instead of doing it.

## Things to ask it

* "What new emails do I have in my work inbox?"
* "Find the email from HR about vacation."
* "Tell Sofía I'll send her the quote tomorrow."
* "Leave me a draft for the client thanking them for the payment."
* "Let me know every 30 minutes if anything urgent comes in."
* "Move the tender emails to archive, it's closed."

## Limits

* **Outlook, Hotmail and Microsoft 365 don't work yet.**
* It needs a mailbox that can be read over IMAP with a password.
* For Gmail, the [Gmail](/en/plugins/gmail) plugin is the better choice.
* It's only for a personal agent.

## If you remove it

Your agent loses access to your mailbox in less than a minute and confirms it. Your address and password are deleted with the plugin; if you add it again, it asks for them again. To close it off completely, also delete the app password at your provider. See [Remove a plugin](/en/tools/remove-a-plugin).

<CardGroup cols={2}>
  <Card title="Gmail" icon="https://mintcdn.com/min-ai/EQr5ljJyas4JWh5G/images/plugins/gmail.png?fit=max&auto=format&n=EQr5ljJyas4JWh5G&q=85&s=d4d0ac0d13d8abdc631a57ecfc72c47f" href="/en/plugins/gmail" width="128" height="128" data-path="images/plugins/gmail.png">
    For Gmail, no passwords.
  </Card>

  <Card title="Keys and values" icon="key" href="/en/tools/keys-and-values">
    How one-time links work.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.