gmail-mcp

Gmail second account MCP server

Читайте и пишите в один почтовый ящик Gmail из Claude.ai и Claude Code. Собственный коннектор Gmail в Claude.ai работает с одной учётной записью, поэтому этот сервер нужен для второй: запустите по экземпляру на каждый почтовый ящик, и каждый коннектор будет обращаться ровно к тому адресу, который ему указан.

Один почтовый ящик на экземпляр

То, какая учётная запись обслуживается экземпляром, берётся из GMAIL_CREDENTIALS_DIR, и из этого процесса больше ничего не доступно. Такое разделение — это суть, а не ограничение: черновик не может попасть не в тот почтовый ящик, если сервер всегда хранит только один набор учётных данных.

Related MCP server: Gmail MCP Local Server

Инструменты

Чтение

Запись

Два инструмента отправки помечены как разрушительные, и в их описаниях об этом сказано: они отправляют сообщения другим людям, и это нельзя отменить. Безопасный порядок — gmail_create_draft, прочитать его, затем gmail_send_draft после того, как человек одобрил текст.

Поиск

gmail_search принимает те же операторы, что и поле поиска Gmail:

is:unread from:client.com
subject:invoice has:attachment newer_than:7d
label:important -in:trash

Он возвращает заголовки и фрагмент для каждого сообщения, а не полное содержимое, поэтому даже широкий поиск остаётся компактным. Затем используйте gmail_get_message или gmail_get_thread.

Как это устроено

Claude.ai / Claude Code
        |  HTTPS
   Cloudflare Tunnel, or any proxy that gives you HTTPS
        |
   nginx  127.0.0.1:8461
        |
   auth-server.js  :8462    handles the login and the tokens
        |
   gmail-mcp  :8460         the server itself, local only
        |
   gmail.googleapis.com

У MCP нет собственного входа, и он принимает подключения только с локальной машины, поэтому всё, что до него доходит, уже прошло авторизацию.

Настройка

Вам нужен OAuth-клиент Google Cloud с включённым Gmail API и refresh-токен для почтового ящика. Каталог учётных данных содержит два файла:

credentials.json        {"refresh_token": "..."}
gcp-oauth.keys.json     the downloaded OAuth client

gmail.modify — это область доступа, которую нужно предоставить. Она покрывает чтение, работу с метками, создание черновиков и отправку; перейдите на gmail.readonly плюс gmail.compose, если хотите, чтобы сами учётные данные не могли отправлять письма.

git clone https://github.com/rollecode/gmail-second-account-mcp.git
cd gmail-second-account-mcp
uv venv && uv pip install -e .
npm install --omit=dev

CONFIG_DIR=~/.config/gmail-mcp node set-password.js 'your-password-here'
openssl rand -hex 32 > ~/.config/gmail-mcp/token
chmod 600 ~/.config/gmail-mcp/token

Заполните YOUR_USER, имя хоста и каталог учётных данных в systemd/*.service и nginx/gmail-mcp.conf, затем:

sudo cp systemd/*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now gmail-mcp gmail-mcp-auth

sudo cp nginx/gmail-mcp.conf /etc/nginx/sites-enabled/gmail-mcp
sudo nginx -t && sudo systemctl reload nginx

Направьте туннель или HTTPS-прокси на 127.0.0.1:8461. Для OAuth требуется HTTPS.

Проверьте извне: discovery возвращает метаданные, а /mcp без токена должен возвращать 401.

curl https://your-host/.well-known/oauth-authorization-server
curl -o /dev/null -w '%{http_code}\n' -X POST https://your-host/mcp

Подключение

Claude.ai: «Настройки», «Коннекторы», «Добавить пользовательский коннектор», https://your-host/mcp, идентификатор клиента и секрет оставьте пустыми.

Claude Code:

claude mcp add --transport http gmail https://your-host/mcp \
  --header "Authorization: Bearer $(cat ~/.config/gmail-mcp/token)" --scope user

Локально через stdio, вообще без сервера:

GMAIL_CREDENTIALS_DIR=/path/to/creds claude mcp add gmail -- /path/to/.venv/bin/gmail-mcp

Параметры

Токены доступа обновляются в памяти по мере истечения срока действия; с диска считывается только refresh-токен.

Благодарности

Слой входа взят из rollecode/obsidian-remote-mcp.