# Manage Email from AI Agents

AI agents often need structured access to email without opening a full mail client. This skill provides script-based IMAP and SMTP workflows for reading, listing, and sending messages.

## Install

```bash
npx skillstore add 7sageer, claude/7sageer-email
```

## Metadata

- Status: approved
- Slug: 7sageer-email
- Version: 0.0.2
- Author version: 0.0.2
- Skillstore revision: r1
- Version status: valid
- Tree hash: 2d2968dc30016a8943b728a300889e26126748435eb677904de946e52386dfd1
- Author: 7Sageer, Claude
- GitHub username: 7Sageer
- License: MIT
- Repository: https://github.com/7Sageer/cc-assistant/tree/main/.claude/skills/email
- Ref: e9e4712298ed071d92417a41714be123eb8364fa
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: blocked
- Manual install advisory: allowed\_with\_warning
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: network, external\_commands, filesystem
- Quality score: 38
- Quality tier: warning
- Public page: https://skillstore.pages.dev/skills/7sageer-email
- Manifest: https://skillstore.pages.dev/api/skills/7sageer-email/manifest

## Capabilities

- Sends plain text email through SMTP using configured account credentials.
- Fetches recent message headers from an IMAP mailbox.
- Reads a specific email by message ID in summary, full, headers, or body format.
- Uses macOS Keychain service entries for IMAP and SMTP passwords.
- Supports account, mailbox, count, recipient, subject, body, and CC options.

## Use Cases

- Check Recent Inbox Activity: List the latest messages with sender, subject, date, and read status for quick triage.
- Send Operational Updates: Send concise plain text notifications from a configured mailbox after details are confirmed.
- Read Message Context: Retrieve a selected message so an assistant can summarize or extract key details.

## Prompt Templates

### Check My Inbox

```
Check my default inbox and summarize the five most recent emails with sender, subject, and date.
```

### Read One Message

```
Read email number 12 from my inbox and give me a short summary with any requested action.
```

### Draft and Send Update

```
Send a plain text email to Alex about the project status after showing me the recipient, subject, and body for confirmation.
```

### Triage a Mailbox Folder

```
Review the latest 20 messages in my Sent folder, identify follow-up items, and read only the messages needed for context.
```

## Limitations

- Requires macOS Keychain and local shell access.
- Does not implement OAuth2 or modern provider-specific authentication flows.
- Does not handle attachments or rich HTML message composition.
- Includes user-specific default account settings that should be replaced before use.

## Best Practices

- Replace all sample account values with your own placeholders before publishing or sharing.
- Require explicit user confirmation before any message is sent.
- Use app-specific passwords or limited-scope credentials when the provider supports them.

## Anti Patterns

- Do not publish a skill with a real personal mailbox as the default account.
- Do not ask an assistant to print Keychain passwords into chat or logs.
- Do not run broad mailbox searches unless the user requested the exact scope.

## Security Audit

- Audited at: 2026-07-04T17:33:26.552\+00:00
- Summary: The skill has legitimate IMAP and SMTP functionality, but it also reads macOS Keychain credentials and can send email from a configured account. I confirmed the sensitive credential access and actual send/read behavior, dismissed many Markdown and benign shell redirection false positives, and added semantic findings for personal account data, missing send confirmation, and account-specific mailbox scraping.

## Stats

- Views: 172
- Downloads: 14
- Favorites: 1
- Popularity score: 0
