yt-zoho-mcp

Zoho Mail 用の MCP サーバー — フォルダーをまたいでメッセージの検索、読み取り、送信、管理を行います。

Model Context Protocol 仕様を実装しています。stdio トランスポート上で動作し、JSON-RPC 2.0 を使用し、initialize でプロトコルバージョンをネゴシエートし、tools 機能をアドバタイズし、各ツールを JSON Schema で記述します。プロトコルバージョンのネゴシエーションは @modelcontextprotocol/sdk の Server クラスによって処理され、デフォルトで最新のサポートバージョンに設定されます。

Tools

Related MCP server: zoho-mail-mcp

Setup

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