yt-zoho-mcp

Zoho Mail용 MCP 서버 — 폴더 전체에서 메시지를 검색, 읽기, 보내기, 관리할 수 있습니다.

Model Context Protocol 사양을 구현합니다: stdio 전송으로 실행되고, JSON-RPC 2.0을 사용하며, initialize에서 프로토콜 버전을 협상하고, tools 기능을 알리며, 각 도구를 JSON Schema로 설명합니다. 프로토콜 버전 협상은 @modelcontextprotocol/sdk의 Server 클래스가 처리하며, 기본값은 최신 지원 버전입니다.

도구

Related MCP server: zoho-mail-mcp

설정

1. Zoho Mail API 클라이언트 만들기

1. Zoho API Console로 이동하세요

2. Self Client(또는 서버 기반 앱)를 만드세요

3. client_id와 client_secret을 복사하세요

4. refresh_token을 얻으려면 offline 범위로 OAuth 토큰을 생성하세요:

   virtualoffice.accounts.read
   virtualoffice.messages.read
   virtualoffice.messages.create
   virtualoffice.messages.update
   virtualoffice.messages.delete

5. Get Accounts 엔드포인트를 통해 account_id를 찾고, 이메일 주소(예: you@example.com)를 기록하세요.

2. 자격 증명 배치

패키지를 설치하면 postinstall 스크립트를 통해 구성 디렉터리 ~/.yt-zoho-mcp(npm 패키지 이름인 yt-zoho-mcp에서 따온 이름)가 자동으로 생성됩니다. 이 디렉터리에 credentials.json을 넣으세요:

{
  "clientId": "...",
  "clientSecret": "...",
  "refreshToken": "...",
  "accountId": "...",
  "email": "you@example.com"
}

서버는 호출할 때마다 refreshToken에서 액세스 토큰을 자동으로 갱신하며, 401 응답이 오면 다시 갱신합니다.

구성

MCP 호스트 구성

opencode

{
  "mcp": {
    "zoho-mail": {
      "type": "local",
      "command": ["npx", "yt-zoho-mcp"]
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "zoho-mail": {
      "command": "npx",
      "args": ["yt-zoho-mcp"]
    }
  }
}

라이선스

MIT