zoho-mail-mcp

Zoho Mail을 위한 Model Context Protocol 서버입니다. Claude(또는 모든 MCP 클라이언트)가 브라우저 자동화 없이 Zoho Mail 계정에서 이메일을 읽고, 검색하고, 보낼 수 있게 해줍니다.

공식 MCP 레지스트리에는 이와 동일한 기능이 없으므로, 이 서버가 그 공백을 메워줍니다.

도구

Related MCP server: claude-gmail-mcp

사전 요구 사항

• Zoho Mail 계정

• Node.js 18 이상

설정

1. Zoho OAuth 앱 생성

1. Zoho API 콘솔로 이동합니다.

2. Self Client 애플리케이션을 생성합니다.

3. Generate Code에서 다음 범위를 추가합니다:

   ZohoMail.messages.READ,ZohoMail.messages.CREATE,ZohoMail.folders.READ,ZohoMail.accounts.READ

4. 만료 시간을 10분으로 설정하고, 설명을 추가한 뒤 Create를 클릭합니다.

5. 생성된 client_id, client_secret 및 code를 복사합니다.

2. 권한 부여 코드를 새로 고침 토큰으로 교환

즉시 실행하세요 (권한 부여 코드는 10분 후에 만료됩니다):

curl -X POST https://accounts.zoho.com/oauth/v2/token \
  -d "grant_type=authorization_code" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "code=YOUR_GRANT_CODE"

응답에서 refresh_token을 저장하세요 — 이 토큰은 만료되지 않습니다.

3. 계정 ID 가져오기

curl -X GET https://mail.zoho.com/api/accounts \
  -H "Authorization: Zoho-oauthtoken YOUR_ACCESS_TOKEN"

data[]의 첫 번째 객체에 있는 accountId 값을 사용하세요.

4. 설치

git clone https://github.com/SirGreed808/zoho-mail-mcp
cd zoho-mail-mcp
npm install

5. Claude Code에 추가

claude mcp add --scope user \
  -e "ZOHO_CLIENT_ID=..." \
  -e "ZOHO_CLIENT_SECRET=..." \
  -e "ZOHO_REFRESH_TOKEN=..." \
  -e "ZOHO_ACCOUNT_ID=..." \
  -e "ZOHO_SENDER=you@yourdomain.com" \
  zoho-mail -- node /absolute/path/to/zoho-mail-mcp/index.js

ZOHO_SENDER는 계정에서 확인된 주소 또는 별칭이어야 합니다.

환경 변수

참고 사항

• 액세스 토큰은 자동으로 새로 고침되므로 수동 개입이 필요하지 않습니다.

• read_email은 messageId와 folderId가 모두 필요하며, 이 두 값은 list_inbox 및 search_emails를 통해 반환됩니다.

• REST API만 사용하며, IMAP/SMTP는 사용하지 않습니다.

라이선스

MIT