check-email
Read emails from Gmail using IMAP. Newest first. Connects via SSL to imap.gmail.com:993, opens folders in read-only mode (no side effects on the mailbox).
Required environment
GMAIL_ADDRESS— Gmail address (IMAP username)GMAIL_APP_PASSWORD— 16-character App Password from Google Account → Security → App Passwords
Without both, the tool returns an error and no data.
Gmail folder names
| Folder | IMAP name |
|---|---|
| Inbox | INBOX |
| Sent | [Gmail]/Sent Mail |
| Drafts | [Gmail]/Drafts |
| All Mail | [Gmail]/All Mail |
| Starred | [Gmail]/Starred |
| Important | [Gmail]/Important |
Examples
{"thought": "check the last 5 inbox emails", "tool": "check-email", "limit": 5}
{"thought": "find unread emails about the quarterly report", "tool": "check-email", "query": "quarterly report", "unseen_only": "true"}
{"thought": "emails from boss this month", "tool": "check-email", "from_addr": "boss@company.com", "since": "2026-05-01"}
Notes
- Email body is capped at 50,000 characters per message.
- Body prefers plain text; HTML is tag-stripped as fallback.