무료GitHub에 공개한국어 소개

agentmail

AI 에이전트 전용 메일함을 만들고 메일 송수신, 답장, 첨부 파일을 처리합니다. 이메일 인증 코드를 확인하고 새 메일 수신 후 작업을 이어 가는 흐름도 설정합니다.

원문원문 설명 보기

Use when an agent needs AgentMail CLI email inboxes.

NousResearch/hermes-agent

AI 평가90점/ 100 설치 방법 보기

이럴 때 유용합니다

AI 에이전트 전용 이메일 주소 생성
메일 발송과 답장·첨부 파일 처리
이메일로 받은 인증 코드 확인
새 메일 수신을 계기로 작업 시작

한국어 소개

할 수 있는 일

agentmail은 AI 에이전트가 사용할 전용 메일함을 만들고 메일을 주고받습니다. 주로 agentmail CLI를 통해 답장, 전달, 대화 묶음 관리, 라벨 지정, 첨부 파일 처리를 수행합니다. 이메일로 받은 일회용 인증 코드를 확인하거나 새 메일을 받은 뒤 작업을 이어 가는 흐름도 다룹니다.

이럴 때 유용합니다

에이전트 자체 이메일 주소가 필요한 작업에 적합합니다. 보낸 메일에 대한 답장을 처리하거나 메일 수신 후 다음 작업을 시작할 때도 사용합니다. 주기적인 수신 확인만으로 부족하면 webhook으로 서버에 알리거나 WebSocket으로 로컬 프로세스에 알릴 수 있습니다.

사용 예시

“에이전트 전용 메일함을 만들고 이메일을 보내 주세요.”
“받은 답장과 첨부 파일을 확인해 주세요.”
“새 메일을 받으면 처리를 시작하는 흐름을 설정해 주세요.”

주의 사항

agentmail-cli 설치와 인증용 AGENTMAIL_API_KEY가 필요합니다. 키가 없을 때 사용할 등록 절차도 제공됩니다. 사용자의 기존 IMAP/SMTP 메일함을 처리하는 용도는 아닙니다. webhook 알림에는 공개 HTTPS 서버가 필요합니다. API 키가 로그나 공유 파일에 남지 않도록 사용해야 합니다.

이 소개문은 공개된 SKILL.md를 바탕으로 AI(OpenAI Codex)가 작성했습니다. 정확한 사양은 아래 원문을 확인하세요.

객관 평가

AI가 SKILL.md의 내용만을 근거로 4가지 관점에서 판정했습니다. 스타 수나 인기도는 판정에 넣지 않았습니다.

지시의 명확성언제 쓰고 무엇을 하는지 알 수 있는가: A양호전용 메일함, 메일 송수신, 인증 코드 확인의 용도와 동작이 명시되어 있습니다.
절차의 구체성절차·입출력·예시가 구체적으로 적혀 있는가: A양호설치부터 알림 추가까지의 절차와 메일함 목록을 JSON으로 받는 명령이 제시되어 있습니다.
안전성전송·삭제·명령 실행 등을 명시하고 있는가: B일부 부족API 키 노출은 금지하지만 메일 발송 전 확인 절차는 명시하지 않습니다.
도입의 용이성필요한 도구나 API 키가 적고 적혀 있는가: A양호CLI 설치, API 키 설정, 키가 없을 때 참고할 등록 안내가 제공됩니다.

총점은 각 항목을 A=25점, B=15점, C=5점으로 더한 값입니다. 2026년 10월 19일 기준으로 AI(OpenAI Codex)가 판정했습니다. 참고용이므로 설치 전에 원문도 확인해 주세요.

평가가 다르다고 생각되면 재검토를 요청하기

포함된 파일(6)

SKILL.md3.1 KB
references/core.md2.9 KB
references/mcp.md313 B
references/signup.md1.1 KB
references/webhooks.md851 B
references/websockets.md1.3 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

AgentMail Skill

AgentMail gives an agent its own email inbox for sending mail, receiving replies, completing email OTP flows, and running inbound email loops. Use it for agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.

Use the agentmail CLI first. Use MCP only when the harness expects MCP tools; use REST only when the CLI is missing a required operation.

When to Use

The agent needs an email address it owns.
The task involves email OTP flows, replies, threads, labels, or attachments.
The agent needs webhook or WebSocket delivery for inbound mail.

Prerequisites

Run commands through the terminal tool.
Install the CLI:

npm install -g agentmail-cli@latest

Export an API key:

export AGENTMAIL_API_KEY="am_..."

No API key yet? Use signup.md.

How to Run

Use --format json whenever another command or script needs IDs.

agentmail inboxes list --format json

Quick Reference

AgentMail agent reference: hosted copy.
AgentMail: product landing page.
Console: API keys and account management.
Docs: full product documentation.
signup.md: self-signup and OTP verification.
core.md: inboxes, messages, threads, labels, attachments.
webhooks.md: events to a public HTTPS server.
websockets.md: events to a local agent process.
mcp.md: MCP integration.

Procedure

Install agentmail-cli@latest and verify agentmail inboxes list --format json.
If no API key is available, complete signup.md.
Use core.md for inbox, send, read, reply, forward, label, thread, and attachment flows.
Add webhooks.md or websockets.md only when polling is not enough.

Pitfalls

Prefer AGENTMAIL_API_KEY over --api-key.
Never expose AGENTMAIL_API_KEY in prompts, logs, URLs, or committed files.
Use stable client_id values for retried create operations.
Prefer extracted_text or extracted_html for LLM input when present.
React to message.received, not messages the agent sent.

Verification

agentmail inboxes list --format json

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

같은 저장소의 스킬