Mail - Email Client

Your intelligent inbox

Overview

Mail is the email application in General Bots Suite. Read, compose, and organize your emails with AI assistance. Mail helps you write better emails, find important messages, and stay on top of your inbox without the clutter.

Features

Folders

Folder	Description
📥 Inbox	Incoming messages
⭐ Starred	Important emails
📤 Sent	Sent messages
📝 Drafts	Unsent drafts
🗑️ Trash	Deleted emails

Labels

Label	Icon	Use For
Urgent	🔴	Time-sensitive
Personal	🟢	Private emails
Work	🔵	Professional
Finance	🟡	Bills & money
Custom	🟣	Create your own

Email Actions

Action	Description
Reply	Respond to sender
Reply All	Respond to all recipients
Forward	Send to someone else
Archive	Remove from inbox
Star	Mark as important
Label	Organize with labels
Delete	Move to trash

Keyboard Shortcuts

Shortcut	Action
`C`	Compose new email
`R`	Reply
`A`	Reply all
`F`	Forward
`E`	Archive
`S`	Star/unstar
`Delete`	Move to trash
`Ctrl+Enter`	Send email
`Escape`	Close/cancel
`↑` / `↓`	Navigate emails

Email via Chat

Checking Your Inbox

Check my email

09:00

📥 You have 5 unread emails:

⭐ Sarah Johnson - Q2 Report Review

📧 Mike Chen - Meeting Tomorrow

📧 LinkedIn - 5 new connections

📧 Newsletter - Weekly Tech Digest

📧 HR Team - Policy Update

09:00

Reading an Email

Read the email from Sarah

09:01

📧 Q2 Report Review

From: Sarah Johnson

Date: Today at 10:32 AM

---

Hi,

Please review the attached Q2 report and let me know if you have any questions. I've highlighted the key metrics on page 3.

📎 Q2-Report.pdf (2.4 MB)

---

[Reply] [Forward] [Archive]

09:01

Composing an Email

Write an email to John about the project deadline

10:30

📝 Here's a draft:

To: john@company.com

Subject: Project Deadline Update

---

Hi John,

I wanted to touch base regarding the project deadline. Could we schedule a quick call to discuss the timeline and any potential adjustments needed?

Let me know your availability.

Best regards

---

[📤 Send] [✏️ Edit] [🗑️ Discard]

10:30

Send it

10:31

✅ Email sent to John!

📤 Subject: Project Deadline Update

10:31

AI-Assisted Writing

Write a polite email declining the meeting invitation for tomorrow

14:20

📝 Here's a polite decline:

Subject: Re: Meeting Tomorrow

---

Hi Mike,

Thank you for the invitation. Unfortunately, I have a scheduling conflict and won't be able to attend tomorrow's meeting.

Would it be possible to reschedule, or could someone share the meeting notes with me afterward?

Thanks for understanding.

Best regards

---

[📤 Send] [✏️ Edit] [🗑️ Discard]

14:20

Searching Emails

Find emails about the budget from last month

11:00

🔍 Found 3 emails about "budget" from last month:

📧 Finance Team - Q1 Budget Review (Apr 15)

📧 Sarah - Budget Approval Needed (Apr 10)

📧 John - Budget Questions (Apr 5)

Which one would you like to read?

11:00

API Endpoints

Endpoint	Method	Description
`/api/email/inbox`	GET	List inbox messages
`/api/email/send`	POST	Send email
`/api/email/draft`	POST	Save draft
`/api/email/:id`	GET	Read email
`/api/email/:id`	DELETE	Delete email
`/api/email/:id/star`	POST	Toggle star
`/api/email/:id/label`	POST	Add label
`/api/email/search`	GET	Search emails

Query Parameters

Parameter	Values	Default
`folder`	`inbox`, `sent`, `drafts`, `trash`, `starred`	`inbox`
`label`	Label name	none
`unread`	`true`, `false`	none
`limit`	1-100	25
`offset`	Number	0

Send Email Request

{
    "to": ["john@company.com"],
    "cc": [],
    "bcc": [],
    "subject": "Project Update",
    "body": "Hi John,\n\nHere's the latest update...",
    "attachments": ["file-id-123"]
}

Email Response

{
    "id": "msg-456",
    "from": "sarah@company.com",
    "to": ["you@company.com"],
    "subject": "Q2 Report Review",
    "body": "Hi,\n\nPlease review the attached...",
    "date": "2025-05-15T10:32:00Z",
    "read": false,
    "starred": true,
    "labels": ["work"],
    "attachments": [
        {
            "id": "att-789",
            "name": "Q2-Report.pdf",
            "size": 2457600
        }
    ]
}

Configuration

Configure email in config.csv:

key,value
smtp-server,smtp.gmail.com
smtp-port,587
imap-server,imap.gmail.com
imap-port,993
email-from,Your Name <you@gmail.com>

Note: Use app-specific passwords for Gmail, not your main password.

Troubleshooting

Emails Not Loading

Check internet connection
Verify email credentials
Check IMAP settings
Refresh the page

Send Fails

Check recipient address
Verify SMTP settings
Check attachment size (max 25MB)
Try again in a moment

Missing Emails

Check spam/junk folder
Verify filters aren’t hiding emails
Check trash folder
Sync may take a few minutes

apps=...,mail

General Bots Documentation