Gmail Attachment MCP Server

Gmail 添付ファイル MCP サーバー

Message Control Protocol（MCP）を使用して Gmail の添付ファイルをダウンロードするマイクロサービスを提供するサーバーです。

概要

このプロジェクトは、メッセージ ID を使用して Gmail のメッセージから添付ファイルをダウンロードできる FastMCP サーバーを実装しています。IMAP を使用して Gmail に接続し、添付ファイルを取得します。

機能

• メッセージ ID を使用して Gmail のメッセージから添付ファイルをダウンロード
• SSL 経由の IMAP を使用した Gmail への安全な接続
• 認証情報を環境変数で設定
• MCP 経由のシンプルな API インターフェース

前提条件

• Python 3.7 以降
• uv がインストールされていること
• IMAP が有効な Gmail アカウント
• Gmail のアプリ パスワード（二段階認証を使用する場合）

インストール

# Clone the repository
git clone https://github.com/yourusername/gmail-attachment-mcp-server.git
cd gmail-attachment-mcp-server

# Install dependencies
uv sync

設定

次の環境変数を設定します。

export GMAIL_USERNAME="[email protected]"
export GMAIL_PASSWORD="your_app_password"
export GMAIL_IMAP_SERVER="imap.gmail.com" # Optional, defaults to imap.gmail.com

注：Gmail では、通常のパスワードではなくアプリ パスワードを使用してください。詳しくはGoogle のドキュメントをご覧ください。

使用方法

サーバーの起動

python server.py
# or
mcp run server.py

ツールの使用

サーバーは、次のパラメーターを受け取る download_attachments_tool を公開します。

• message_id：16 進数形式の Gmail メッセージ ID
• download_folder：（任意）添付ファイルのダウンロード先フォルダー（既定値は「./attachments」です）

この関数は、ダウンロードした添付ファイルのパスのリストを返します。

mcp inspector での使用

npx @modelcontextprotocol/inspector uv run mcp run server.py

goose での使用

extensions:
  gmail-attachment-mcp-server:
    args:
      - run
      - /path to virtual env/.venv/bin/mcp
      - run
      - /path to gmail-attachment-mcp-server/server.py
    bundled: null
    cmd: uv
    description: null
    enabled: true
    env_keys:
      - GMAIL_USERNAME
      - GMAIL_PASSWORD
    envs: {}
    name: gmail-attachment-mcp-server
    timeout: 300
    type: stdio

API リファレンス

download_attachments_tool

download_attachments_tool(message_id: str, download_folder="./attachments") -> list[str]

メッセージ ID で指定した Gmail メッセージから添付ファイルをダウンロードします。

パラメーター：

• message_id：16 進数形式の Gmail メッセージ ID
• download_folder：（任意）添付ファイルのダウンロード先フォルダー（既定値は「./attachments」です）

戻り値：

• ダウンロードした添付ファイルのパスを含む文字列のリスト

ライセンス

MIT