IMAPを介してYahoo Mailのフルメール管理を提供するモデルコンテキストプロトコル(MCP)サーバー。 ローカルstdioトランスポート(Claude Desktop用)とHTTP/SSEトランスポート(Claude.ai経由でリモートアクセス用)の両方に対応しています。

##特徴

• セキュアOAuth 2.0認証: リモート MCP サーバーを OAuth 2.0 認可コードで PKCE で保護
• UIDベースの操作: 電子メールが削除されたときに変更されない永続的な IMAP UID を使用する (v3.0.0+)
• 完全な電子メール管理: バッチ処理サポートによる完全なメール操作
• 11強力なツール:
• [search_emails: フィルター(日付範囲、送信者、未読状態)による高度な検索
• [mark_as_read]: マーク 電子メール 読み込み
• [flag_emails: 重要な/星付きとして電子メールをフラグする

Yahoo Mail MCP Server

A Model Context Protocol (MCP) server that provides full email management for Yahoo Mail via IMAP. This server supports both local stdio transport (for Claude Desktop) and HTTP/SSE transport (for remote access via Claude.ai).

Features

• Secure OAuth 2.0 Authentication: Protect your remote MCP server with OAuth 2.0 authorization code flow with PKCE
• UID-Based Operations: Uses permanent IMAP UIDs that don’t change when emails are deleted (v3.0.0+)
• Full Email Management: Complete email operations with batch processing support
• Eleven Powerful Tools:
  • list_emails: List recent emails with enriched metadata (size, flags, attachments) and pagination
  • read_email: Read the full content of emails (batch support)
  • search_emails: Advanced search with filters (date ranges, sender, unread status)
  • list_folders: Discover all available IMAP folders
  • delete_emails: Move emails to Trash (soft delete, recoverable)
  • archive_emails: Archive emails for long-term storage
  • mark_as_read: Mark emails as read
  • mark_as_unread: Mark emails as unread
  • flag_emails: Flag emails as important/starred
  • unflag_emails: Remove flag from emails
  • move_emails: Move emails to any folder
• Enriched Metadata: All emails include UID, size, flags, hasAttachments, and folder information
• Advanced Search: Filter by date range, sender, unread status, and search across any folder
• Batch Operations: All management operations support processing multiple emails at once with accurate success/failure tracking
• Dual Transport Modes:
  • stdio: For local Claude Desktop integration
  • sse: For remote access via HTTP/Server-Sent Events (required for Render.com)
• Cross-Platform: Works on both Windows and Linux development environments
• Docker Support: Containerized deployment with Docker and Docker Compose
• Cloud Ready: Configured for easy deployment to Render.com with OAuth security

Prerequisites

For Local Development

• Node.js: Version 18.0.0 or higher
• Yahoo Mail Account: With app-specific password enabled
• Git: For version control

For Docker Development/Deployment

• Docker: Latest version
• Docker Compose: Latest version (included with Docker Desktop on Windows/Mac)

For Render.com Deployment

• GitHub Account: To host your repository
• Render.com Account: Free tier available at https://render.com

Quick Start

1. Clone and Setup

# Clone the repository
git clone 
cd yahoo-mail-mcp-server

# Copy environment template
cp .env.example .env

2. Get Yahoo Mail App Password

1. Go to https://login.yahoo.com/account/security
2. Click “Generate app password” or “Manage app passwords”
3. Select “Other App” and enter “MCP Server”
4. Copy the generated 16-character password

3. Configure Environment

Edit .env file with your credentials: