yahoo-mail

Yahoo Mail MCP Server for Claude Desktop

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio jtokib-yahoo-mail-mcp-server node server.js \
  --env PORT="3000" \
  --env YAHOO_EMAIL="your.email@yahoo.com" \
  --env TRANSPORT_MODE="stdio or sse" \
  --env OAUTH_CLIENT_ID="your-oauth-client-id" \
  --env YAHOO_APP_PASSWORD="your16charpassword" \
  --env OAUTH_CLIENT_SECRET="your-oauth-client-secret"

How to use

This Yahoo Mail MCP Server provides a comprehensive set of tools to manage Yahoo Mail via IMAP through the MCP (Model Context Protocol). It supports two transport modes: stdio for local Claude Desktop integration and HTTP/SSE for remote access via Claude.ai. The server exposes eleven tools for common email tasks, including listing and reading emails, performing advanced searches, managing folders, and performing batch operations. Each email record includes enriched metadata such as UID, size, flags, hasAttachments, and folder information, enabling precise, scalable interactions with your mailbox. You can operate on multiple emails at once and leverage both UID-based operations and robust filtering to craft complex workflows.

How to install

Prerequisites:

Node.js 18.x or higher
Git
A Yahoo Mail account with an app password generated for OAuth (see your Yahoo security settings)

Clone the repository git clone <your-repo-url> cd yahoo-mail-mcp-server
Copy environment template cp .env.example .env
Install dependencies npm install
Configure environment variables Edit .env and set your credentials and mode, for example: YAHOO_EMAIL=your.email@yahoo.com YAHOO_APP_PASSWORD=your16charpassword TRANSPORT_MODE=stdio # or 'sse' PORT=3000
Run in stdio mode (local Claude Desktop) npm run start:stdio
Run in SSE mode (HTTP endpoint for remote access) npm run start:sse
Development with auto-reload npm run dev

Optional Docker usage:

Build and run using npm scripts for Docker integration as documented in the repo's README, or adapt your own Dockerfile and docker-compose.yml accordingly.

Additional notes

Notes and tips:

For Render.com deployment, you’ll typically set environment variables such as YAHOO_EMAIL, YAHOO_APP_PASSWORD, OAUTH_CLIENT_ID, and OAUTH_CLIENT_SECRET. Ensure sensitive values are marked as secrets in your deployment provider.
When using OAuth, ensure your OAuth client is registered and that PKCE flow is supported by your backend implementation.
The stdio transport is intended for local development with Claude Desktop; the SSE transport is required for remote usage and Render.com deployments.
UID-based IMAP operations rely on IMAP servers supporting persistent UIDs; this behavior is supported by v3.0.0+ of the server.
If you encounter connection issues with Yahoo, verify app passwords and the OAuth credentials, and ensure your environment variables are correctly loaded by the process.
If you need to change the listening port, update the PORT variable and any downstream service configuration accordingly.

Related MCP Servers

zen

1.1k

Selfhosted notes app. Single golang binary, notes stored as markdown within SQLite, full-text search, very low resource usage

MCP -Deepseek_R1

A Model Context Protocol (MCP) server implementation connecting Claude Desktop with DeepSeek's language models (R1/V3)

mcp-fhir

A Model Context Protocol implementation for FHIR

mcp

Inkdrop Model Context Protocol Server

mcp-appium-gestures

This is a Model Context Protocol (MCP) server providing resources and tools for Appium mobile gestures using Actions API..

dubco -npm

The (Unofficial) dubco-mcp-server enables AI assistants to manage Dub.co short links via the Model Context Protocol. It provides three MCP tools: create_link for generating new short URLs, update_link for modifying existing links, and delete_link for removing short links.