GY

gdigora/yandex-mail-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

8 stars 8 forks 품질 55 트렌드 16

MCP 서버 Yandex 메일 - 읽기, 검색 및 IMAP / SMTP를 통해 이메일을 보내

개요

MCP (모델 컨텍스트 프로토콜) Yandex 메일 서버. Enables Claude Desktop 및 기타 MCP 클라이언트가 읽고, 검색하고, Yandex Mail을 통해 이메일을 보내주십시오. - — 암호로 고쳐진 러시아어 폴더 이름 - — sender, subject, date, 또는 custom IMAP 쿼리 (지원 Cyrillic) - — text/HTML body로 전체 콘텐츠 - - 디스크에 저장 - - - - 일반 텍스트 또는 HTML - — mailbox를 구성 1. Yandex ID로 이동 2. 사용 가능 (앱 암호 필요) 3. 이동 4. "Mail" 5.에 대한 새로운 앱 암호 생성 생성된 암호를 .env로 복사 ~/Library/Application Support/Claude/claude desktop config.json에 추가하십시오: 설정 후 Restart Claude 데스크탑.

개요(AI 번역)

MCP (모델 컨텍스트 프로토콜) Yandex 메일 서버. Enables Claude Desktop 및 기타 MCP 클라이언트가 읽고, 검색하고, Yandex Mail을 통해 이메일을 보내주십시오.

특징

  • List 폴더 - 디코딩 러시아어 폴더 이름
  • 검색 이메일 — 발송인, 제목, 날짜, 또는 사용자 지정 IMAP 쿼리 (지원 Cyrillic) -Read email — text/HTML body로 전체 콘텐츠
  • ** 첨부 파일 다운로드 ** - 디스크에 저장
  • ** 이메일 보내기 ** - 일반 텍스트 또는 HTML -Move/Delete 이메일 - mailbox 구성

설치

Yandex 설치

  1. Yandex ID로 이동
  2. EnableTwo-Factor 인증 (앱 비밀번호 필요)
  3. 보안 → 앱 비밀번호로 이동
  4. "Mail"에 대한 새로운 앱 암호 만들기
  5. 생성된 비밀번호 복사 .env

Claude 데스크탑 구성

~/Library/Application Support/Claude/claude_desktop_config.json에 추가:

설정 후 Restart Claude 데스크탑.

사용 가능한 도구

도구 설명
[T2] 모든 메일박스 폴더 일람
search_emails(folder, query, limit) IMAP 쿼리의 이메일 검색
[T4] 전체 이메일 내용 보기

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

Yandex Mail MCP Server

MCP (Model Context Protocol) server for Yandex Mail. Enables Claude Desktop and other MCP clients to read, search, and send emails via Yandex Mail.

Features

  • List folders — with decoded Russian folder names
  • Search emails — by sender, subject, date, or custom IMAP queries (supports Cyrillic)
  • Read emails — full content with text/HTML body
  • Download attachments — save to disk
  • Send emails — plain text or HTML
  • Move/Delete emails — organize your mailbox

Installation

# Clone the repository
git clone https://github.com/yourusername/yandex-mail-mcp.git
cd yandex-mail-mcp

# Create virtual environment
python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Configure credentials
cp .env.example .env
# Edit .env with your Yandex email and app password

Yandex Setup

  1. Go to Yandex ID
  2. Enable Two-Factor Authentication (required for app passwords)
  3. Go to Security → App Passwords
  4. Create new app password for “Mail”
  5. Copy the generated password to .env

Claude Desktop Configuration

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "yandex-mail": {
      "command": "/path/to/yandex-mail-mcp/.venv/bin/python",
      "args": ["/path/to/yandex-mail-mcp/server.py"]
    }
  }
}

Restart Claude Desktop after configuration.

Available Tools

Tool Description
list_folders() List all mailbox folders
search_emails(folder, query, limit) Search emails with IMAP queries
read_email(folder, email_id) Read full email content
download_attachment(folder, email_id, filename, save_dir) Download attachment to disk
send_email(to, subject, body, cc, bcc, html) Send an email
move_email(folder, email_id, destination) Move email to another folder
delete_email(folder, email_id) Delete email (move to Trash)

Search Query Examples

ALL                          # All emails
UNSEEN                       # Unread emails
FROM [email protected]      # From specific sender
SUBJECT hello                # Subject contains "hello"
SINCE 01-Dec-2024            # Emails since date
UNSEEN FROM [email protected] # Combined query

Running Tests

source .venv/bin/activate
pytest test_server.py -v

License

MIT

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "yandex-mail": { "command": "/path/to/yandex-mail-mcp/.venv/bin/python", "args": ["/path/to/yandex-mail-mcp/server.py"] } } }