yahoo-mail-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yahoo-mail-mcp-server list my recent emails"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
yahoo-mail-mcp-server
An MCP server that gives Claude Desktop or Claude Code access to a Yahoo Mail account over IMAP/SMTP: list, search, read, and send email.
Tools
Tool | Description |
| List recent emails in a folder (default |
| Search by sender, subject substring, or unseen status. |
| Fetch the full text/HTML body of one email by UID. |
| Send an email from the configured account. |
Related MCP server: yahoo-mail-mcp
1. Generate a Yahoo App Password
Yahoo Mail requires an app password, not your normal account password, for third-party IMAP/SMTP access:
Go to Yahoo Account Security.
Enable two-step verification if it isn't already on.
Under "App passwords", generate a new one (e.g. name it
mcp-server).Copy the 16-character password — you won't be able to see it again.
Never use your real Yahoo login password here, and never commit it anywhere.
2. Install
git clone https://github.com/satishkovuru/yahoo-mail-mcp-server
cd yahoo-mail-mcp-server
npm install3. Configure credentials
Copy .env.example to .env and fill in your address and app password:
cp .env.example .envYAHOO_EMAIL=you@yahoo.com
YAHOO_APP_PASSWORD=your16charapppassword.env is gitignored — never commit real credentials.
4. Wire it into Claude Desktop / Claude Code
Add an entry to your MCP client config
(claude_desktop_config.json, found under %APPDATA%\Claude\ on Windows or
~/Library/Application Support/Claude/ on macOS; for Claude Code use its
.mcp.json or claude mcp add):
{
"mcpServers": {
"yahoo-mail": {
"command": "node",
"args": ["/absolute/path/to/yahoo-mail-mcp-server/src/index.js"],
"env": {
"YAHOO_EMAIL": "you@yahoo.com",
"YAHOO_APP_PASSWORD": "your16charapppassword"
}
}
}
}Credentials belong in the env block of your local config file, which stays
on your machine — never in a file you commit to a repository.
Restart Claude Desktop (or restart your Claude Code session) and the
yahoo-mail tools will be available.
Notes
Uses
imapflowfor IMAP,nodemailerfor SMTP, and the official@modelcontextprotocol/sdk.Default IMAP/SMTP hosts are Yahoo's (
imap.mail.yahoo.com,smtp.mail.yahoo.com); override viaYAHOO_IMAP_HOST,YAHOO_IMAP_PORT,YAHOO_SMTP_HOST,YAHOO_SMTP_PORTif needed.This project is not affiliated with or endorsed by Yahoo.
Available Tools
4 toolsget_emailC
Fetch the full content of one email by UID.
Inputs: uid (required), folder.
list_emailsA
List recent emails in a Yahoo Mail folder (default INBOX), most recent first.
Inputs: limit, folder.
search_emailsC
Search emails in a folder by sender, subject substring, or unseen status.
Inputs: from, limit, folder, subject, +1 more.
send_emailC
Send an email from the configured Yahoo Mail account.
Inputs: to (required), body (required), subject (required), cc, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
list_emails and search_emails both return email lists, but search_emails adds filtering criteria while list_emails is purely chronological. get_email and send_email target distinct resources and actions, making overall selection clear.
All tools follow a consistent verb_noun pattern (list_emails, search_emails, get_email, send_email). The convention is predictable and easy to scan.
Four tools provide a focused core for basic email interaction without bloat. It is slightly thin for a full email client, but each tool earns its place.
Core read and send operations are covered, but common email lifecycle actions like delete, mark read/unread, move, and list folders are missing. Agents can handle simple tasks but will hit dead ends for routine mailbox management.
Maintenance
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Bring Gmail, Outlook, iCloud Mail, Yahoo Mail, Fastmail and other IMAP mailboxes together. Search connected email, including semantic search; cached or indexed results may be incomplete or stale. Read messages and attachments, create drafts, send or reply when requested, and manage rules for new mail. Separate permissions control reading, attachments, drafts, sending and mailbox changes.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables users to manage their Yahoo Mail account through natural language, including listing, reading, searching, deleting, archiving, flagging, and moving emails via IMAP. Supports both local Claude Desktop integration and remote access with secure OAuth 2.0 authentication.11MIT
- AlicenseNot gradedqualityCmaintenanceEnables controlling Yahoo Mail from Claude in plain English — read, search, organize, delete, and send emails, with a two-phase confirmation step to prevent accidental destructive actions.MIT
- AlicenseNot gradedqualityCmaintenanceEnables Claude to read, search, organize, and clean up Yahoo Mail emails over IMAP without Yahoo API keys.4MIT
- AlicenseAqualityBmaintenanceEnables Claude to access Yahoo Mail via IMAP, allowing users to list folders, search and read emails, download attachments, and manage flags, moves, and deletions.9MIT