星战科技xingzhan.cloud
返回市场
Gmail邮件服务管理器

Gmail邮件服务管理器

作者：ykuchiki4 星标更新：2025-10-08
安装使用来源：spider==github.com

项目介绍

Gmail MCP

<p align="center"> <img src="https://github.com/ykuchiki/gmail-mcp/blob/main/assets/gmail-mcp-logo.png" alt="Gmail MCP Logo" width="200"> </p> <p align="center"> <a href="https://github.com/ykuchiki/gmail-mcp/LICENSE"> <img src="https://img.shields.io/github/license/ykuchiki/gmail-mcp" alt="License"> </a> <img src="https://img.shields.io/badge/python-3.11+-blue.svg" alt="Python 版本"> <img src="https://img.shields.io/badge/MCP-compatible-brightgreen.svg" alt="MCP 兼容"> </p> <p align="center"> <b>通过模型上下文协议（MCP），使AI助手能够与Gmail进行交互的API</b><br> <b><a href="#english">English</a> | <a href="#spanish">Español</a> | <a href="#japanese">日本語</a></b> </p>

<a id="english"></a>

📋 英文文档

欢迎向此仓库提交拉取请求。

📖 目录

<a id="overview"></a>

🔍 概述

Gmail MCP 是一个服务器实现，它使AI助手能够通过MCP（模型上下文协议）与Gmail进行交互。它提供了发送邮件、管理草稿、阅读邮件、搜索收件箱以及管理Gmail标签的工具。

<a id="features"></a>

✨ 功能

  • ✉️ 发送邮件和创建草稿
  • 📬 阅读和搜索邮件
  • 🗑️ 删除邮件
  • 🏷️ 管理Gmail标签（创建、更新、删除）
  • 🔐 与Gmail API的OAuth2.0认证

<a id="prerequisites"></a>

📋 前提条件

  • Python 3.11或更高版本
  • Gmail账户
  • 已启用Gmail API的Google Cloud Platform项目
  • uv - Python包安装器

<a id="setup"></a>

🚀 设置

  1. 克隆此仓库
git clone https://github.com/ykuchiki/gmail-mcp.git
cd gmail-mcp
  1. 创建并激活虚拟环境
uv init
  1. 安装依赖项
uv pip install -r requirements.txt

  1. 设置OAuth凭证

    • 在项目的根目录下创建名为credentials的目录
    • 在Google Cloud Console中创建一个项目
    • 启用Gmail API
    • 创建OAuth凭证
    • 将以下URI添加到授权重定向URI中： 
      http://localhost:8080/
    • 下载凭证JSON文件，并将其保存为credentials/client_secret_gmail_oauth.json

  2. 添加MCP服务器 请参阅您的MCP客户端官方文档以获取具体说明。确保根据您的环境调整路径。

{
    "mcpServers": {
        "gmail-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/your/gmail-mcp/src",
                "run",
                "main.py"
            ]
        }
    }
}
  1. 运行服务器
uv run main.py

<a id="usage"></a>

💡 使用

该服务器可以与任何MCP兼容客户端一起使用。首次运行时，它会提示您使用Gmail账户进行身份验证。

<a id="license"></a>

📄 许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

<a id="japanese"></a>

📋 日语文档

本リポジトリはpullリクエスト大歓迎です。

📖 目次

<a id="概要"></a>

🔍 概要

Gmail MCPは、AIアシスタントがMCP（モデルコンテキストプロトコル）を通じてGmailを使用できるようにするサーバー実装です。メールの送信、下書きの管理、メールの読み取り、受信トレイの検索、Gmailラベルの管理などのツールを提供します。

<a id="機能"></a>

✨ 機能

  • ✉️ メールの送信と下書き作成
  • 📬 メールの読み取りと検索
  • 🗑️ メールの削除
  • 🏷️ Gmailラベルの管理（作成、更新、削除）
  • 🔐 Gmail APIとのOAuth2.0認証 - 📎 添付ファイル送信・下書き（複数可, ローカルファイルパス）

<a id="前提条件"></a>

📋 前提条件

  • Python 3.11以上
  • Gmailアカウント
  • Gmail APIが有効化されたGoogle Cloud Platformプロジェクト
  • uv - Pythonパッケージインストーラー

<a id="セットアップ"></a>

🚀 セットアップ

  1. リポジトリをクローン
git clone https://github.com/ykuchiki/gmail-mcp.git
cd gmail-mcp
  1. 仮想環境の作成と有効化
uv init
  1. 依存関係のインストール
uv pip install -r requirements.txt

  1. OAuth認証情報の設定

    • 最初にプロジェクトのルートディレクトリ直下にcredentialsディレクトリを作成
    • Google Cloud Consoleでプロジェクトを作成
    • Gmail APIを有効化
    • OAuth認証情報を作成
    • 認証済みのリダイレクトURIに以下を追加: 
      http://localhost:8080/
    • 認証情報JSONファイルをダウンロードし、credentials/client_secret_gmail_oauth.jsonとして保存

  2. MCPサーバーを追加 追加方法はご使用のMCPクライアントの公式ドキュメントをご確認ください。 また、パスは環境に合わせて修正してください。

{
    "mcpServers": {
        "gmail-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/your/gmail-mcp/src",
                "run",
                "main.py"
            ]
        }
    }
}
  1. サーバーの実行
uv run main.py

<a id="使用方法"></a>

💡 使用方法

このサーバーは、MCP互換のクライアントと共に使用できます。初回実行時には、Gmailアカウントで認証するよう促されます。

添付ファイルを付けて送信 / 下書き作成

attachments 引数でローカルファイルのパスを指定します（複数可・絶対パス推奨）。

例: 送信

{
  "to": ["someone@example.com"],
  "subject": "レポート送付の件",
  "body": "ご確認ください。",
  "attachments": [
    "/Users/you/Documents/report.pdf",
    "/Users/you/Pictures/logo.png"
  ]
}

例: 下書き作成

{
  "to": ["someone@example.com"],
  "subject": "資料",
  "body": "添付しています。",
  "attachments": ["/absolute/path/to/file.txt"]
}

注意事項:

  • 合計サイズは約24MBを上限とし、それを超える場合はエラーになります（Gmailの25MB制限に対する安全余裕）。
  • MIMEタイプは自動推定します。判別できない場合はapplication/octet-streamとして送信します。
  • ファイルが存在しない/読み取り不可の場合はエラーになります。

<a id="ライセンス"></a>

📄 ライセンス

このプロジェクトはMITライセンスの下で提供されています - 詳細はLICENSEファイルをご覧ください。

<a id="spanish"></a>

📋 西班牙语文档

欢迎向此仓库提交拉取请求。

📖 目录

<a id="descripción-general"></a>

🔍 描述

Gmail MCP是一个服务器实现，它允许AI助手通过MCP（模型上下文协议）与Gmail进行交互。它提供了发送电子邮件、管理草稿、阅读电子邮件、搜索收件箱以及管理Gmail标签的工具。

<a id="características"></a>

✨ 特性

  • ✉️ 发送电子邮件和创建草稿
  • 📬 阅读和搜索电子邮件
  • 🗑️ 删除电子邮件
  • 🏷️ 管理Gmail标签（创建、更新、删除）
  • 🔐 与Gmail API的OAuth2.0认证

<a id="requisitos-previos"></a>

📋 前提条件

  • Python 3.11或更高版本
  • Gmail账户
  • 已启用Gmail API的Google Cloud Platform项目
  • uv - Python包安装器

<a id="configuración"></a>

🚀 配置

  1. 克隆此仓库
git clone https://github.com/ykuchiki/gmail-mcp.git
cd gmail-mcp
  1. 创建并激活虚拟环境
uv init
  1. 安装依赖项
uv pip install -r requirements.txt

  1. 设置OAuth凭证

    • 在项目的根目录下创建名为credentials的目录
    • 在Google Cloud Console中创建一个项目
    • 启用Gmail API
    • 创建OAuth凭证
    • 将以下URI添加到授权重定向URI中： 
      http://localhost:8080/
    • 下载凭证JSON文件，并将其保存为credentials/client_secret_gmail_oauth.json

  2. 添加MCP服务器 请参阅您的MCP客户端官方文档以获取具体说明。确保根据您的环境调整路径。

{
    "mcpServers": {
        "gmail-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/your/gmail-mcp/src",
                "run",
                "main.py"
            ]
        }
    }
}
  1. 运行服务器
uv run main.py

<a id="uso"></a>

💡 使用

该服务器可以与任何MCP兼容客户端一起使用。首次运行时，它会提示您使用Gmail账户进行身份验证。

<a id="licencia"></a>

📄 许可证

本项目采用MIT许可证 - 详情见LICENSE文件。

TODO

  • 基本功能实现
  • search_emails中排除发送邮件ID或采用不同方法实现