Skip to content
MCP server

Yahoo Mail MCP

MCP server that lets Claude read, search, organize and clean up Yahoo Mail over IMAP

Pricing
Open source
Platforms
CLI, self-hosted, macOS
Version
1.0.0
Listing updated
today

Similar MCP servers

About Yahoo Mail MCP

Yahoo Mail MCP is an open-source MCP server for productivity. It is available on CLI, self-hosted, macOS, Windows and Linux.

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.

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free and MIT licensed; runs locally.

Yahoo Mail MCP 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.

How AIPoweredBot checks servers