yagms

yagms

さらに別の Gmail MCP サーバー

セットアップと使用方法

Gmail MCP サーバー

Gmail MCP サーバーは、Model Context Protocol（MCP）を通じて 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 # It will emit ./dist/gmail.js

認証

Gmail MCP サーバーを使用する前に、Google アカウントで認証する必要があります。

# Run the authentication flow
bun run dist/gmail.js auth

これにより、次の処理が行われます。

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

サーバーの実行

認証後、Gmail MCP サーバーを実行できます。

# Run the server
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:[email protected] 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": []
    }
  }
}