davidvornholt/standards 기반으로 구축되었습니다.
Thunderbird 워크플로우를 위한 초안 전용 IMAP 헬퍼로, Codex, Claude 및 기타 호환 클라이언트에는 MCP 서버로, 사용자에게는 하나의 공유 Effect 코어 기반 mail CLI로 제공됩니다. MCP 서버를 통해 메일과 수신 첨부 파일을 검색하고 읽을 수 있으며, HTML 및 첨부 파일이 포함된 초안을 생성, 업데이트 또는 삭제할 수 있습니다. mail CLI는 로그인, 상태, 폴더/검색/읽기, 일반 텍스트 초안 생성을 다룹니다. 이메일을 보낼 수는 없습니다. 초안은 검토 및 전송을 위해 Thunderbird로 동기화됩니다.
apps/mail the application (MCP server + CLI)
src/app entrypoints: server.ts (MCP, stdio), cli.ts (the `mail` bin)
src/features/mail schemas, tagged errors, and Effect services (config, secrets, status, IMAP, draft, login)
src/shared app-local infrastructure (arg parsing, hidden-input terminal prompt)
packages/* canonical shared config synced from the standards template도구 목록, 구성 및 비밀 처리에 대해서는 apps/mail/README.md를 참조하세요.
Related MCP server: imap-mcp
bun install
# put the `mail` command on your PATH (one-time; links the app's bin into
# ~/.bun/bin). After this, run `mail …` from anywhere.
bun link --cwd apps/mail
# configure your accounts (non-secret: addresses, IMAP hosts, and ports). The real
# file is git-ignored so your addresses never land in git.
cp apps/mail/accounts.example.toml apps/mail/accounts.toml
# …edit apps/mail/accounts.toml…
# verify every account's password against IMAP, then store each in the OS keyring
# (hidden prompts — nothing is echoed or written to disk). Run this yourself;
# the secrets never leave your machine.
mail login
# confirm each account authenticates cleanly (or shows what still needs a login)
mail statusCodex에 MCP 서버를 등록합니다:
codex mcp add mail -- bun run <repo>/apps/mail/src/app/server.ts
codex mcp get mailCodex는 MCP 도구 정의를 관련 시점까지 지연시키므로, 서버를 등록해도 모든 메일 도구 스키마가 모델 컨텍스트에 즉시 추가되지는 않습니다. 추가한 후 Codex를 재시작하고 /mcp를 사용하여 연결된 서버를 확인하세요.
명시적인 쓰기 승인과 IMAP 작업을 위한 더 많은 여유 공간을 확보하려면 ~/.codex/config.toml에 생성된 항목을 편집하세요:
[mcp_servers.mail]
command = "bun"
args = ["run", "<repo>/apps/mail/src/app/server.ts"]
startup_timeout_sec = 15
tool_timeout_sec = 120
default_tools_approval_mode = "writes"
[mcp_servers.mail.tools.delete_draft]
approval_mode = "prompt"Claude Code(사용자 범위)의 경우 다음을 사용하세요:
claude mcp add --scope user mail -- bun run <repo>/apps/mail/src/app/server.ts비밀번호가 저장되면 MCP 클라이언트에 메일 검색 또는 초안 작성을 요청하세요. 검토 우선 CLI를 직접 사용할 수도 있습니다:
mail search invoice
mail search --account you@example.com invoice--account를 생략하면 구성된 모든 계정을 검색하고 결과를 병합 및 중복 제거하며 제한을 전역적으로 적용합니다. 특정 계정만 검색하려면 --account <email>을 전달하세요. 각 결과에는 계정 핸들이 포함되며, 개별 계정의 실패는 부분 결과와 함께 보고됩니다. 모든 계정이 실패하면 명령은 모든 계정 오류와 함께 실패합니다.
폴더 검색은 계정별로 수행됩니다. 정확한 폴더 하나를 검색하려면 mail search --account you@example.com --scope folder --folder INBOX ...를, 폴더와 하위 폴더를 검색하려면 --scope subtree --folder Projects를 사용하세요.
전역 명령을 연결할 준비가 되지 않았나요? 모든 예제는 bun run apps/mail/src/app/cli.ts <args>로도 작동합니다.
Bun(package.json의 packageManager 참조).
OS 키링을 위한 실행 중이고 잠금 해제된 Secret Service 공급자(gnome-keyring).
bun run check는 표준 드리프트 검사를 실행한 다음 모든 워크스페이스에서 린트, 타입 검사, 테스트, 빌드 및 a11y를 실행합니다. 변경이 완료되기 전에 반드시 통과해야 합니다.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Read, search, send, organize, draft and schedule email across your inboxes from any MCP client.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/davidvornholt/mail-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server