이메일을 읽고, 검색하고, 정리하고, 보내는 MCP 서버입니다. IMAP과 SMTP.

[! 참고] 버전 1.0.0은 로컬 이메일 앱 V2를 도입합니다. 패키지 업데이트는 그렇지 않습니다 PyPI 0.16.0 이전 버전으로 생성된 기존 설정을 자동으로 가져오세요: 하위 호환 모드인 legacy 모드에서 계속 활성화되어 있으므로, 필수 기능은 없습니다 이주. 만약 새로 관리되는 저장소를 사용하고 싶으시면, 검토하고 가져오실 수 있습니다 편할 때 설정을 >하세요.

mcp-email-server는 Windows, macOS, Linux를 지원합니다. 자세한 내용은 플랫폼별 파일 시스템 및 자격 증명의 보안 보관 세부사항.

기존 설치에 대한 선택적 마이그레이션

로컬 이메일 앱 V2가 포함된 @latest 릴리스는 미리보기 기능을 제공합니다 CLI 마이그레이션:

적용 단계는 다시 계획을 표시하고 IMPORT 확인을 요청합니다. A 완전 가져오기 선택은 관리 모드; 그렇지 않으면 기존 레거시 설정이 적용됩니다 선택된 상태로 남아 있습니다. 소스 TOML 파일과 그 레거시 키링 항목은 남습니다 손대지 않은 상태입니다. uvx mcp-email-server@latest ui를 실행하여 가져오기(import)를 선택할 수도 있습니다 기존 설정. 성공적으로 가져오기 후에는 MCP 클라이언트를 다시 실행하세요. 참고하세요 상세 업그레이드 가이드

mcp-email-server

An MCP server for reading, searching, organizing, and sending email through IMAP and SMTP.

[!NOTE] Version 1.0.0 introduces Local Email App V2. Updating the package does not automatically import existing settings created with PyPI 0.16.0 and earlier: they remain active in backward-compatible legacy mode, so there is no required migration. If you would like to use the new managed storage, you can review and import those settings whenever it is convenient.

mcp-email-server supports Windows, macOS, and Linux. See Security for platform-specific filesystem and credential storage details.

Optional migration for existing installations

An @latest release that includes Local Email App V2 offers a preview-first CLI migration:

uvx mcp-email-server@latest config init \
  --database ~/.config/mcp-email-server/managed.sqlite3
uvx mcp-email-server@latest config import-legacy
uvx mcp-email-server@latest config import-legacy --apply
uvx mcp-email-server@latest config doctor

The apply step displays the plan again and asks for IMPORT confirmation. A complete import selects managed mode; otherwise the existing legacy settings remain selected. The source TOML file and its legacy keyring entries are left untouched. You can also run uvx mcp-email-server@latest ui and choose Import existing settings. After a successful import, restart running MCP clients. See the detailed upgrade guidance and import troubleshooting.

Quick start

1. Configure an email account

From this source checkout, run the configuration UI with uv:

uv sync
uv run mcp-email-server ui

For a published release whose notes state that it includes Local Email App V2, uvx mcp-email-server@latest ui is the equivalent temporary invocation.

Keep the foreground command running. On a truly empty installation, the authenticated browser session prepares private account storage at the safe local default; existing TOML or environment configuration instead offers an explicit import review while the previous settings keep running. The account-first UI has