local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

References a Discord community for updates on the evolving MCP protocol and community engagement.
Provides configuration instructions specific to macOS for the Claude Desktop integration.
Provides distribution of the agentmail-mcp package through the Python Package Index, allowing users to easily install the MCP server.

AgentMail MCP 통합

AgentMail 과 통합되어 Claude와 같은 AI 비서를 통해 이메일 받은편지함을 동적으로 관리하고, 메시지를 나열하고, 이메일을 보내거나 답장할 수 있는 간단한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 참조 구현은 MCP 서버 내에서 AgentMail의 API를 사용하여 이메일 받은편지함을 실시간으로 조정하는 방법을 보여줍니다.

AgentMail 소개

AgentMail은 AI 에이전트가 이메일을 주고받고 처리할 수 있도록 즉시 받은편지함을 생성할 수 있는 API 기반 이메일 제공 업체 입니다. 에이전트 워크플로에 최적화된 이메일 레이어 위에 구축된 인텔리전스 레이어를 통해 LLM(기업 관리자)이 데이터를 쉽게 소화할 수 있도록 지원합니다. API 키를 요청하세요!

중요 참고 사항

MCP 프로토콜이 아직 발전 중이므로 이 패키지는 개발 중입니다. 새로운 기능이 추가되는 대로 업데이트하겠습니다. 디스코드에 가입하여 커뮤니티에 참여하세요! 디스코드

특징

동적으로 새로운 받은 편지함을 즉시 생성
받은 편지함을 나열하고 검색하여 활성 상태를 확인하세요.
AgentMail 받은 편지함에서 이메일을 보내세요
기존 스레드 내의 메시지에 답장
선택한 받은 편지함에 대한 스레드 및 메시지 나열
메시지 첨부 파일 검색

필수 조건

파이썬 3.10+
AgentMail API 키
(선택 사항) Claude Desktop 또는 MCP 명령을 지원하는 다른 프런트엔드

설치

이 프로젝트에는 PyPi 패키지가 있습니다. 설치가 완료되면 Claude Desktop 설정에서 참조하거나 직접 실행하여 이메일 관리 도구를 활성화할 수 있습니다.

PIP(로컬 또는 PyPI)

자체 Python 환경을 유지 관리하는 경우 가상 환경(PyPI 또는 로컬 소스)에서 패키지를 설치하기만 하면 됩니다.

지엑스피1

그런 다음 실행하세요.

agentmail-mcp --api-key="YOUR_AGENTMAIL_API_KEY"

이렇게 하면 로컬 컴퓨터에서 서버가 실행됩니다.

옵션 1: Claude Desktop 사용

Claude Desktop에서 서버와 상호 작용하려면 다음 단계를 정확히 따르세요.

가상 환경을 활성화하세요.

source .venv/bin/activate

Agentmail MCP 서버 패키지의 위치를 확인하려면 아래 줄을 실행하세요. 가상 환경에 agentmail-mcp 패키지를 설치했다면 .venv/bin/ 디렉터리에 있을 것입니다. Claude Desktop의 경우, 가상 환경에 설치하는 것이 중요합니다.

which agentmail-mcp

반환된 경로를 복사합니다.
claude_desktop_config.json 파일의 command 필드에 경로를 붙여넣습니다.
Claude Desktop을 다시 시작합니다.

claude_desktop_config.json 파일은 다음과 같습니다.

{
  "mcpServers": {
    "agentmail-mcp": {
      "command": "/path/to/agentmail-mcp",
      "args": ["--api-key", "{AGENT_MAIL_API_KEY}"]
    }
  }
}

claude_desktop_config.json 파일이 없으면 다음 디렉토리에 파일을 만드세요.

macOS에서는 구성 파일이 일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json에 있습니다.

Windows에서는 일반적으로 %APPDATA%/Claude/claude_desktop_config.json에 있습니다.

저장 후 Claude Desktop을 다시 시작하여 새로운 MCP 서버를 로드합니다.

용법

Claude Desktop(또는 다른 MCP 클라이언트)에서 서버를 실행하면 AgentMail MCP 도구에 매핑되는 자연어 명령을 Claude에 전달할 수 있습니다. 예: • "demo라는 이름의 새 받은 편지함을 만듭니다." • "내 모든 받은 편지함을 나열합니다." • "inbox test@agentmail.to 에서 test@example.com 으로 'Hello'라는 제목으로 지난주 샌프란시스코 날씨를 설명하는 이메일을 보냅니다." • "inbox abc123의 가장 최근 메시지에 답장합니다."

내부적으로 Claude는 노출된 MCP 도구(create_inbox, list_inboxes, send_message 등)를 호출하고, 이 도구는 다시 AgentMail API를 호출합니다.

특허

MIT 라이선스 - 이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 사용 시 모든 책임은 사용자에게 있습니다.

⸻

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

View all tools

AI 상담원에게 즉시 받은 편지함을 제공합니다. 상담원/LLM은 분리된 받은 편지함에서 메시지를 보내고 받고 작업을 수행할 수 있습니다. Gmail과 달리 AI를 위해 설계되었습니다. agentmail.to에서 확인해 보세요.