# Overview

The MailAgent Gmail Addon brings AI-powered email assistance directly into your Gmail inbox as a sidebar. No context switching, no copy-pasting — just open an email and let the AI help.

## What It Does

When installed, the addon adds a sidebar panel to Gmail with the following capabilities:

* **AI Agent** — Toggle an autonomous AI that monitors your inbox and responds to emails automatically.
* **Draft Mode** — Choose whether the AI sends emails directly or creates drafts for your review.
* **Custom Prompt** — Define the AI's personality, tone, and behavior with a system prompt.
* **Email Labels** — Automatically classify and label processed emails.
* **Email Signature** — Append a custom footer to all AI-generated emails.
* **Integrations** — Connect MCP servers and GitBook knowledge bases for context-aware responses.
* **Process Email** — Manually trigger the AI to respond to the currently open email.
* **Quick Replies** — Get AI-suggested reply options when viewing an email.
* **Reports** — View email processing statistics.
* **User ID** — Your unique identifier, displayed at the bottom of the settings panel. You'll need this to [integrate the widget](https://support.mailagent.email/widget/getting-started).

## How It Works

```
┌─────────────────────────────────────────────┐
│  Gmail Inbox                                │
│  ┌────────────────────┐  ┌────────────────┐ │
│  │                    │  │  MailAgent      │ │
│  │   Email Thread     │  │  Sidebar       │ │
│  │                    │  │                │ │
│  │                    │  │  [AI Agent: ON] │ │
│  │                    │  │  Draft Mode     │ │
│  │                    │  │  Integrations   │ │
│  │                    │  │  Prompt         │ │
│  │                    │  │  Labels         │ │
│  │                    │  │  Signature      │ │
│  │                    │  │                │ │
│  └────────────────────┘  └────────────────┘ │
└─────────────────────────────────────────────┘
```

1. **Automatic Mode** — When the AI Agent is enabled, MailAgent watches for new unread emails via Gmail push notifications. For each new email, it reads the thread, generates a response using your configured prompt and integrations, and either sends the reply or creates a draft.
2. **Manual Mode** — When the AI Agent is disabled, you can still open any email and click "Process Email" to generate a response on demand. The addon will show the email's intent, quick reply suggestions, and a custom prompt field for generating replies.

## Subscription Plans

| Plan         | Daily Email Limit | Features          |
| ------------ | ----------------- | ----------------- |
| **Starter**  | 10 emails/day     | All core features |
| **Standard** | 50 emails/day     | All core features |
| **Pro**      | Unlimited         | All core features |

Your daily usage counter resets automatically every 24 hours.