G5

gx-55/multi-gmail-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

19 stars 12 forks Качество 79 Тренд 30MIT

Сервер Model Context Protocol (MCP), который позволяет работать одновременно. Занесен в официальный реестр Anthropic MCP и опубликован на npm.

Обзор

Сервер Model Context Protocol (MCP), который позволяет работать одновременно. Занесен в официальный реестр Anthropic MCP и опубликован на npm. - Подключение - личные, рабочие, побочные проекты - любой почтовый ящик с использованием полного синтаксиса поиска Gmail - полные электронные письма с анализом MIME - , , и - с ярлыками: добавить, удалить, список, архив - - Токены, хранящиеся локально в ~ /.gmail-mcp-tokens.db - никогда не обязуются git - Auto-refreshes OAuth токены молча - Node.js >= 22.5.0 - Проект Google Cloud с включенным API Gmail - Claude Desktop Это регистрирует две глобальные команды: gmail-mcp (сервер MCP) и gmail-mcp-cli (менеджер учетных записей). 1.Перейти на console.cloud.google.com → создать проект 2.Включить (APIs & Services → Library) 3.Настроить — Внешний, добавить свои адреса Gmail в качестве тестовых пользователей 4. Добавить разделы: gmail.readonly, gmail.send, gmail.modify, gmail.labels 5.Создать учетные данные OAuth → скачать JSON 6. Сохраните его в ~/.gmail-mcp-oauth.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), который позволяет Claude Desktop управлять несколькими учетными записями Gmail одновременно. Занесен в официальный реестр Anthropic MCP и опубликован на npm.

Особенности

Подключите ** неограниченные учетные записи Gmail** — личные, рабочие, побочные проекты Поиск любого почтового ящика с использованием полного синтаксиса поиска Gmail **Читайте ** полные электронные письма с MIME парсингом Отправить, ответить в потоке и создать черновики **Организовать ** с ярлыками: добавить, удалить, список, архив Марка читать/не читать Токены, хранящиеся локально в ~/.gmail-mcp-tokens.db — никогда не обязывались к git

  • Токены OAuth молча

Требования

  • Node.js >= 22.5.0 Google Cloud с включенным API Gmail Клод Десктоп

##Установка

При этом регистрируются две глобальные команды: gmail-mcp (сервер MCP) и gmail-mcp-cli (менеджер аккаунта).

Настройка Google Cloud

Вам нужно сделать это только один раз.

1.Перейти на console.cloud.google.com → создать проект 2.Включить Gmail API (APIs & Services → Library) 3.Настройте экран согласия OAuth — Внешний, добавьте свои адреса Gmail в качестве тестовых пользователей 4. Добавить разделы: gmail.readonly, gmail.send, gmail.modify, 'gmail.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

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
Открыть полный README на GitHub

Установка

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

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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