IMAP을 통해 Yahoo Mail의 전체 이메일 관리를 제공하는 모델 Context Protocol (MCP) 서버. 이 서버는 로컬 stdio 운송 (클래드 데스크톱 용) 및 HTTP / SSE 운송 (클래드를 통해 원격 액세스 용)을 지원합니다.

특징

• Secure OAuth 2.0 인증: PKCE를 가진 OAuth 2.0 허가 부호 교류를 가진 당신의 먼 MCP 서버를 보호하십시오
• **UID 기반 운영 **: 이메일이 삭제될 때 변경하지 않는 영구 IMAP UID를 사용하십시오 (v3.0.0+)
• ** 전체 이메일 관리**: 일괄 처리 지원으로 완벽한 이메일 작업
• Eleven 강력한 도구:
• list_emails: enriched metadata (size, flags, Attachs) 및 pagination을 가진 최근 이메일 목록
• read_email: 이메일의 전체 내용을 읽으십시오 (배치 지원)
• search_emails: 필터와 고급 검색 (날짜 범위, 보낸 사람, 읽지 않은 상태)
• list_folders: 모든 IMAP 폴더를 발견
• delete_emails: Trash로 이메일 이동 (soft delete, recoverable)
• archive_emails: 장기 보관용 이메일
• mark_as_read: 읽음으로 Mark Email
• [T7]]: 읽지 않은 표시
• flag_emails: 중요한/starred로 깃발 이메일
• [T9]]: 이메일에서 플래그 제거

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: