Skip to main content
Glama
yahoo-mail-mcp-server

yahoo-mail-mcp-server

by satishkovuru

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_emails

List recent emails in a folder (default INBOX), newest first.

search_emails

Search by sender, subject substring, or unseen status.

get_email

Fetch the full text/HTML body of one email by UID.

send_email

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:

  1. Go to Yahoo Account Security.

  2. Enable two-step verification if it isn't already on.

  3. Under "App passwords", generate a new one (e.g. name it mcp-server).

  4. 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 install

3. Configure credentials

Copy .env.example to .env and fill in your address and app password:

cp .env.example .env
YAHOO_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 imapflow for IMAP, nodemailer for SMTP, and the official @modelcontextprotocol/sdk.

  • Default IMAP/SMTP hosts are Yahoo's (imap.mail.yahoo.com, smtp.mail.yahoo.com); override via YAHOO_IMAP_HOST, YAHOO_IMAP_PORT, YAHOO_SMTP_HOST, YAHOO_SMTP_PORT if needed.

  • This project is not affiliated with or endorsed by Yahoo.

Available Tools

4 tools
get_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

    B3.2/5.0

    Scored across 4 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern (list_emails, search_emails, get_email, send_email). The convention is predictable and easy to scan.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      11
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude to read, search, organize, and clean up Yahoo Mail emails over IMAP without Yahoo API keys.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables Claude to access Yahoo Mail via IMAP, allowing users to list folders, search and read emails, download attachments, and manage flags, moves, and deletions.
      9
      MIT