
gx-55/multi-gmail-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер 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.
- Go to console.cloud.google.com → create a project
- Enable the Gmail API (APIs & Services → Library)
- Configure the OAuth consent screen — External, add your Gmail addresses as test users
- Add scopes:
gmail.readonly,gmail.send,gmail.modify,gmail.labels - Create a Desktop app OAuth credential → download the JSON
- 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 |
|---|
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"multi-gmail": {
"command": "gmail-mcp"
}
}
}