shinzo-labs/gmail-mcp

Gmail MCP サーバー

Gmail API 用のモデルコンテキストプロトコル(MCP)サーバーの実装で、メール管理、送信、および検索のための標準化されたインターフェイスを提供します。

##特徴

• メッセージ、スレッド、ラベル、ドラフト、および設定を含む完全なGmail APIのカバレッジ -メールの送信、ドラフト、管理のサポート
• カスタマイズ可能な色と可視性の設定によるラベル管理
• 会話管理のためのスレッド操作
• 休暇対応者、IMAP/POP、言語設定を含む設定管理
• メールボックスの変更のための履歴追跡
• Google Cloud 認証情報を使用して OAuth2 認証をセキュアに

前提条件

依存関係

最も簡単なインストールでは、Node.js 18 +をインストールします。 ローカルでビルドしたい場合、pnpm をインストールする必要があります。

##Googleワークスペースセットアップ

この MCP サーバーを実行するには、組織の Google API クライアントを設定する必要があります。各ユーザーは独自の OAuth リフレッシュ トークンを取得するためにスクリプトを実行します。

Google API クライアント設定 (組織ごとにオンス)

1。 Googleクラウドコンソールに移動します。 2. 新規プロジェクトを作成するか、既存のプロジェクトを選択します。 3. プロジェクトの Gmail API を有効にします。 4.

A Model Context Protocol (MCP) server implementation for the Gmail API, providing a standardized interface for email management, sending, and retrieval.

Features

• Complete Gmail API coverage including messages, threads, labels, drafts, and settings
• Support for sending, drafting, and managing emails
• Label management with customizable colors and visibility settings
• Thread operations for conversation management
• Settings management including vacation responder, IMAP/POP, and language settings
• History tracking for mailbox changes
• Secure OAuth2 authentication using Google Cloud credentials

Prerequisites

Dependencies

For simplest installation, install Node.js 18+. If you would like to build locally, you will also need to install pnpm.

Google Workspace Setup

To run this MCP server, you will need to set up a Google API Client for your organization, with each user running a script to retrieve their own OAuth refresh token.

Google API Client Setup (once per organization)

1. Go to the Google Cloud Console.
2. Create a new project or select an existing one.
3. Enable the Gmail API for your project.
4. Go to Credentials and create an OAuth 2.0 Client ID. Choose “Desktop app” for the client type.
5. Download and save the OAuth keys JSON as ~/.gmail-mcp/gcp-oauth.keys.json. ⚠️ NOTE: to create ~/.gmail-mcp/ through MacOS’s Finder app you need to enable hidden files first.
6. (Optional) For remote server installation (ex. using Smithery CLI), note the CLIENT_ID and CLIENT_SECRET from this file.