Yagms

🚀 Yet Another Gmail MCP サーバー

Yet Another Gmail MCP サーバーは、モデルコンテキストプロトコル（MCP）を通じて Gmail アカウントと相互作用するためのツールを提供します。

🚀 クイックスタート

✨ 主な機能

Gmail MCP サーバーは、モデルコンテキストプロトコル（MCP）を介して Gmail アカウントとの相互作用を可能にするツールを提供します。具体的には、メールの一覧表示、特定のメールの取得、メールの検索、Gmail ラベルの取得などの機能があります。

📦 インストール

前提条件

1. Gmail API 用の OAuth 認証情報を作成します。
   • Google Cloud Consoleにアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • Gmail API を有効にします。
   • OAuth 2.0 認証情報（デスクトップアプリ）を作成します。
   • 認証情報の JSON ファイルをダウンロードし、~/.yagms - oauth.keys.json として保存します。

このプロジェクトのビルド

1. Bun をインストールします。
2. コードをビルドします。

bun install
bun run build - gmail # ./dist/gmail.js で出力されます

💻 使用例

認証

Gmail MCP サーバーを使用する前に、認証を行う必要があります。

# 認証プロセスを実行
bun run dist/gmail.js auth

これにより、以下のことが行われます：

• Google アカウントにログインするためのブラウザウィンドウが開きます。
• Gmail アカウントへのアクセス許可を要求します。
• 認証情報を ~/.yagms - credentials.json に保存します。

サーバーの起動

認証が完了したら、Gmail MCP サーバーを起動できます。

# サーバーを起動
bun run src/gmail.ts

設定

環境変数を使用して、OAuth 認証情報と認証情報の保存先をカスタマイズできます。

• GMAIL_OAUTH_PATH：OAuth 認証情報ファイルのパス（デフォルト：~/.yagms - oauth.keys.json）
• GMAIL_CREDENTIALS_PATH：認証情報を保存するパス（デフォルト：~/.yagms - credentials.json）

利用可能なツール

Gmail MCP サーバーは以下のツールを提供します。

基本的な使用法

1. list - emails：受信トレイ内の電子メールを取得します。

   • パラメータ：
     • senderEmail（オプション）：送信者のメールアドレスでフィルタリングします。
     • maxResults（オプション、デフォルト：10）：返す最大メール数です。
     • labelIds（オプション、デフォルト：["INBOX"]）：ラベル ID でフィルタリングします。

2. get - email：ID を指定して特定の電子メールを取得します。

   • パラメータ：
     • emailId：取得する電子メールの ID です。

高度な使用法

3. search - emails：Gmail 検索構文を使用して電子メールを検索します。

   • パラメータ：
     • query：Gmail 検索クエリ（例："from:example@gmail.com has:attachment"）
     • maxResults（オプション、デフォルト：10）：返す最大メール数です。

4. get - labels：すべての Gmail ラベルを取得します。

   • パラメータ：なし

サンプル MCP 設定

この内容を MCP 設定ファイルに追加します。

{
  "mcpServers": {
    "gmail": {
      "command": "bun",
      "args": ["run", "/path/to/yagms/dist/gmail.js"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}