G5

gx-55/multi-gmail-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

19 stars 12 forks 品質 79 トレンド 30MIT

同時にできるモデルコンテキストプロトコル(MCP)サーバー。 Anthropic MCP の公式レジストリにリストされ、npm で公開されています.

概要

同時にできるモデルコンテキストプロトコル(MCP)サーバー。 Anthropic MCP の公式レジストリにリストされ、npm で公開されています。 - 接続 — 個人的、仕事、サイドプロジェクト - 完全なGmail検索構文を使用して任意の受信トレイ - MIME解析との完全なメール - 、および - ラベル付き: ラベルの追加、削除、リスト、アーカイブ - - ローカルに保存されたトークンは、~/.gmail-mcp-tokens.db - gitにコミットしません - 自動修正 OAuthトークンは静かに - Node.js >= 22.5.0 - Gmail API 対応の Google Cloud プロジェクト - Claude デスクトップ gmail-mcp (MCP サーバー) と gmail-mcp-cli (アカウントマネージャー) の2つのグローバルコマンドを登録します。 1。 console.cloud.google.com → プロジェクト2を作成します。 (APIとサービス→ライブラリ)3を有効にします。 - 外部の設定、Gmailアドレスをテストユーザー4として追加します。 スコープの追加: gmail.readonly, gmail.send, gmail.modify, gmail.labels 5。 OAuthクレデンシャルを作成 → JSON 6をダウンロードします。 ~/.gmail-mcp-oauth に保存します.

概要(AI 翻訳)

**Claude Desktopが複数のGmailアカウントを同時に管理できるモデルコンテキストプロトコル(MCP)サーバー。 Anthropic MCP の公式レジストリにリストされ、npm で公開されています。

お問い合わせ

##特徴

  • [Gmailアカウントを無制限に接続]** - 個人、仕事、サイドプロジェクト -完全なGmail検索構文を使用して任意の受信トレイを検索
  • MIMEの解析で完全なメールを読む -Send、スレッドに返信、作成草
  • ラベルで組織**:追加、削除、リスト、アーカイブ
  • 既読/未読のマーク
  • ローカルに格納されているトークン ~/.gmail-mcp-tokens.db — git にコミットしない
  • 自動refreshes OAuthトークンを静かに

お問い合わせ

要件

  • Node.js >= 22.5.0
  • Gmail API 対応の Google Cloud プロジェクト
  • クロードデスクトップ

お問い合わせ

インストール

このコマンドは、[gmail-mcp(MCPサーバー)と[gmail-mcp-cli(アカウントマネージャー)の2つのグローバルコマンドを登録します。

お問い合わせ

Googleクラウドセットアップ

一度だけこれを行う必要があります。

  1. Console.cloud.google.com → プロジェクトを作成する 2.Gmail APIを有効にします(APIとサービス→ライブラリ) 3。OAuthの同意画面の構成 - 外部に、Gmailアドレスをテストユーザーとして追加します
  2. スコープの追加: [`gmail.readonly`, [`gmail.send`], [[`gmail.modify`]], `gmail.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

multi-gmail-mcp

A Model Context Protocol (MCP) server that lets Claude Desktop manage multiple Gmail accounts simultaneously. Listed on the official Anthropic MCP registry and published on npm.


Features

  • Connect unlimited Gmail accounts — personal, work, side projects
  • Search any inbox using full Gmail search syntax
  • Read complete emails with MIME parsing
  • Send, reply in thread, and create drafts
  • Organize with labels: add, remove, list, archive
  • Mark as read / unread
  • Tokens stored locally in ~/.gmail-mcp-tokens.db — never committed to git
  • Auto-refreshes OAuth tokens silently

Requirements

  • Node.js >= 22.5.0
  • A Google Cloud project with the Gmail API enabled
  • Claude Desktop

Installation

npm install -g multi-gmail-mcp

This registers two global commands: gmail-mcp (the MCP server) and gmail-mcp-cli (account manager).


Google Cloud Setup

You only need to do this once.

  1. Go to console.cloud.google.com → create a project
  2. Enable the Gmail API (APIs & Services → Library)
  3. Configure the OAuth consent screen — External, add your Gmail addresses as test users
  4. Add scopes: gmail.readonly, gmail.send, gmail.modify, gmail.labels
  5. Create a Desktop app OAuth credential → download the JSON
  6. Save it to ~/.gmail-mcp-oauth.json

Alternatively, set environment variables in the Claude Desktop config (see below).


Authenticating Gmail Accounts

# Add accounts (opens browser for Google sign-in)
gmail-mcp-cli add [email protected]
gmail-mcp-cli add [email protected]

# List authenticated accounts
gmail-mcp-cli list

# Remove an account
gmail-mcp-cli remove [email protected]

Tokens are saved to ~/.gmail-mcp-tokens.db and refreshed automatically.


Claude Desktop Configuration

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp"
    }
  }
}

If you prefer environment variables over ~/.gmail-mcp-oauth.json:

{
  "mcpServers": {
    "multi-gmail": {
      "command": "gmail-mcp",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Restart Claude Desktop after saving. Click the hammer icon to confirm 19 tools are loaded.


Available Tools

Account Management

Tool Description
list_accounts List all authenticated Gmail accounts
initiate_auth Start OAuth flow — returns a URL to open in browser
complete_auth Finalize auth after completing Google sign-in
remove_account Remove an account and its stored credentials

Reading Email

Tool Description
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "multi-gmail": { "command": "gmail-mcp" } } }