モデルコンテキストプロトコル（MCP）用の Gmail サーバー

この MCP サーバーは Gmail と統合され、電子メールの送信、削除、読み取り、下書き、返信が可能になります。

注: このサーバーは、MCPクライアントがメールの読み取り、削除、送信を行うことを可能にします。ただし、クライアントはこれらの操作を行う前にユーザーに確認メッセージを表示します。

https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90

コンポーネント

ツール

メールを送信
- メールアドレスの受信者にメールを送信します
- 入力：
  - recipient_id (文字列): 受信者のメールアドレス
  - subject （文字列）：メールの件名
  - message (文字列): メールの内容
- ステータスとmessage_idを返します
ゴミ箱メール
- メールをゴミ箱に移動する
- 入力：
  - email_id (文字列): メールの自動生成されたID
- 成功メッセージを返す
メールを既読にする
- メールを既読にする
- 入力：
  - email_id (文字列): メールの自動生成されたID
- 成功メッセージを返す
未読メールを取得する
- 未読メールを取得します
- メールIDを含むメールのリストを返します
メールを読む
- 指定されたメールの内容を取得します
- 入力：
  - email_id (文字列): メールの自動生成されたID
- メールのメタデータの辞書を返し、メールを既読としてマークします
オープンメール
- ブラウザでメールを開く
- 入力：
  - email_id (文字列): メールの自動生成されたID
- 成功メッセージを返し、指定されたメールをデフォルトのブラウザで開きます

Related MCP server: MCP Google Workspace Server

設定

Gmail API のセットアップ

新しい Google Cloud プロジェクトを作成する
Gmail APIを有効にする
OAuth同意画面を設定する
- 「外部」を選択してください。ただし、アプリは公開されません。
- 個人のメールアドレスを「テストユーザー」として追加します。
OAuth スコープを追加しますhttps://www.googleapis.com/auth/gmail/modify
アプリケーションタイプ「デスクトップアプリ」のOAuth クライアント ID を作成します
クライアントのOAuthキーのJSONファイルをダウンロードします
キーファイルの名前を変更し、ローカルマシンの安全な場所に保存してください。保存場所をメモしておいてください。
- このファイルへの絶対パスは、サーバーの起動時にパラメーター--creds-file-pathとして渡されます。

認証

サーバーが起動すると、システムブラウザで認証フローが開始されます。トークンの認証情報は、パラメータ--token-pathに渡された絶対ファイルパスに保存され、後で取得されます。

たとえば、ホームフォルダー内のドットディレクトリを使用して、 [your-home-folder]を置き換えます。

パラメータ	例
`--creds-file-path`	`/[your-home-folder]/.google/client_creds.json`
`--token-path`	`/[your-home-folder]/.google/app_tokens.json`

デスクトップアプリでの使用

uvの使用をお勧めします。

このサーバーをMCPクライアントとしてClaude Desktopと統合するには、アプリのサーバー構成に以下のコードを追加してください。デフォルトでは、 ~/Library/Application\ Support/Claude/claude_desktop_config.jsonに保存されています。

{
  "mcpServers": {
    "gdrive": {
      "command": "uv",
      "args": [
        "--directory",
        "[absolute-path-to-git-repo]",
        "run",
        "gmail",
        "--creds-file-path",
        "[absolute-path-to-credentials-file]",
        "--token-path",
        "[absolute-path-to-access-tokens-file]"
      ]
    }
  }
}

以下のパラメータを設定する必要があります

パラメータ	例
`--directory`	サーバーを含む`gmail`ディレクトリへの絶対パス
`--creds-file-path`	Gmail API セットアップで作成された認証情報ファイルへの絶対パス。
`--token-path`	アプリケーションのアクセストークンとリフレッシュトークンを保存および取得するための絶対パス。

MCP Inspectorによるトラブルシューティング

サーバーをテストするには、 MCP Inspectorを使用します。gitリポジトリから、以下のコマンドを実行し、パラメータ引数を適宜変更してください。

npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]