Gmail Server for Model Context Protocol (MCP)
Интеграция с Gmail для отправки, чтения, удаления и управления emails через протокол MCP
Описание
Это сервер MCP для Gmail, использующий Google Gmail API. Он позволяет отправлять emails, перемещать в корзину, отмечать как прочитанные, получать непрочитанные письма, читать содержимое и открывать в браузере. Технологии: OAuth для аутентификации, Python для реализации. Применения: автоматизация email-задач в AI-клиентах вроде Claude Desktop, с подтверждением пользователя перед действиями.
Возможности
Отправка email
Отправляет письмо по указанному адресу с темой и содержимым, возвращает статус и ID.
Удаление email
Перемещает email в корзину по ID.
Отметка как прочитанное
Отмечает email как прочитанный по ID.
Получение непрочитанных emails
Возвращает список непрочитанных писем с ID.
Чтение email
Получает содержимое email по ID, отмечает как прочитанный и возвращает метаданные.
Открытие email в браузере
Открывает email в браузере по ID.
Установка
Для установки настройте Gmail API: создайте проект в Google Cloud, включите API, настройте OAuth consent screen (external, добавьте тест-юзера), добавьте scope https://www.googleapis.com/auth/gmail/modify, создайте OAuth Client ID (Desktop App), скачайте JSON-ключи. Сохраните файл как client_creds.json. Для Claude Desktop добавьте в claude_desktop_config.json:
{
"mcpServers": {
"gdrive": {
"command": "uv",
"args": [
"--directory",
"[absolute-path-to-git-repo]",
"run",
"gmail",
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
]
}
}
}
```Аутентификация через браузер при запуске. Для теста используйте MCP Inspector: `npx @modelcontextprotocol/inspector uv run [path]/src/gmail/server.py --creds-file-path [path] --token-path [path]`