# Yahoo Mail MCP

> Yahoo Mail MCP is an open-source MCP server for productivity. MCP server that lets Claude read, search, organize and clean up Yahoo Mail over IMAP. It is available on CLI, self-hosted, macOS, Windows and Linux.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Repository:** https://github.com/andesstriker/yahoo-mail-mcp
- **MCP Registry name:** io.github.andesstriker/yahoo-mail-mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

The README says this server connects Claude to a Yahoo Mail account over plain IMAP, so no Yahoo developer API keys or OAuth setup are needed. Access relies on an account-specific App Password generated in Yahoo's security settings.

Each tool call opens a short-lived IMAP connection, performs one action and closes it. Available operations cover listing and creating folders, searching by sender, subject, date or unread status, reading message bodies and attachments, moving single messages, and toggling the read flag.

Deletion is soft by default: messages go to the Trash folder found through IMAP special-use flags, and permanent removal requires an explicit flag. The project suits people who want an AI assistant to triage a personal or small-business inbox while keeping deletions recoverable.

## Features

- **Folder and message search:** Lists folders with special-use flags and searches a folder by sender, subject, date range or unread status.
- **Full message reading:** Returns headers and body text, with HTML stripped to plain text, plus attachment filenames.
- **Attachment download:** Fetches a single attachment as base64-encoded bytes by message UID and filename.
- **Safe soft delete:** Moves deleted messages to Trash by default, and permanent expunge requires passing permanent=True.
- **Single-message operations:** Moves and deletes act on individual messages by UID, and no tool removes an entire folder.
- **Read status control:** Marks messages as read or unread through the IMAP \Seen flag.

## Good for

- Triage an unread inbox by asking Claude to list and summarize new messages
- Find an invoice or receipt by sender and download its attachment
- Sort incoming mail into newly created folders such as Receipts
- Clear out spam by moving or deleting selected messages after review

## Tools

- `list_folders`: List every IMAP folder/label, with special-use flags
- `create_folder`: Create a folder if it doesn't already exist (idempotent)
- `list_emails`: List recent emails in a folder, newest first
- `search_emails`: Search a folder by sender/subject/date range/unread, AND-combined
- `read_email`: Fetch full headers and body plus attachment filenames
- `get_attachment`: Fetch one attachment's raw bytes, base64-encoded
- `move_email`: Move a single message between folders by UID
- `delete_email`: Delete a message, soft-delete (Trash) by default
- `mark_email`: Set or unset the read (\Seen) flag

## FAQ

### Does it need a Yahoo API key?

No. The README says it uses standard IMAP with an account-scoped App Password, and no Yahoo API keys or OAuth are involved.

### Is deleted mail recoverable?

By default, delete_email moves the message to Trash. Only calls with permanent=True expunge the message immediately.

### Can it delete a whole folder?

No. The README states that no tool can delete or expunge an entire folder; operations address single messages by UID.

### What is needed to set it up?

Python 3.10 or later, two-step verification enabled on the Yahoo account to create an App Password, and registration in Claude Desktop or Claude Code.

### Is Yahoo Mail MCP free?

Yes. Yahoo Mail MCP is open source, so you can use and self-host it for free.

### What are the best alternatives to Yahoo Mail MCP?

The closest alternatives to Yahoo Mail MCP are mcp4mail, mcp-mail, inboxmcp, mailmcp and MCPEmails.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [mcp4mail](https://ai-powered.com/mcp/mcp4mail): mcp4mail is an open-source MCP server for communication.
- [mcp-mail](https://ai-powered.com/mcp/mcp-mail): mcp-mail is an open-source MCP server for communication.
- [inboxmcp](https://ai-powered.com/mcp/inboxmcp-2): inboxmcp is a freemium MCP server for communication.
- [mailmcp](https://ai-powered.com/mcp/mailmcp): mailmcp is a freemium MCP server for communication.
- [MCPEmails](https://ai-powered.com/mcp/mcpemails): MCPEmails is a freemium MCP server for communication.
- [Domailo](https://ai-powered.com/mcp/domailo): Domailo is an MCP server for communication.
- [macOS Apps](https://ai-powered.com/mcp/macos-apps): macOS Apps is a free MCP server for productivity.
- [Apple Mail](https://ai-powered.com/mcp/apple-mail-2): Apple Mail is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/yahoo-mail-mcp
