Provides tools for sorting personal Gmail, including managing labels, reading unread messages, and setting up automated email organization through the Gmail API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@gmail-sorter show my unread emails and sort them into labels"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Система сортировки личного Gmail на мультиагентах Claude Code. Полная архитектура — в
architecture.md. Этот репозиторий реализует её по фазам.
Статус: Фазы 0–4. Продакшн-запуск на VPS по расписанию — см. docs/runbook.md.
Python 3.11+
(для живых Gmail-вызовов) OAuth-клиент из Google Cloud Console с включённым Gmail API
Related MCP server: multi-gmail-mcp
python -m venv .venv
# Windows PowerShell:
.venv\Scripts\Activate.ps1
# Linux/macOS:
# source .venv/bin/activate
pip install -e ".[dev]"python -m pytestБД создаётся автоматически при старте MCP-сервера. Вручную:
python -c "import sys; sys.path.insert(0,'mcp'); import db; db.init_db('data/state.db'); print('ok')"# Положи скачанный client_secret в .gmail-credentials.json (см. .env.example)
python mcp/google_auth.py # откроет браузер, сохранит .gmail-token.jsonpython scripts/setup_labels.pyСкопируй .claude/settings.local.json.example → .claude/settings.local.json. ВАЖНО: значение command должно указывать на python из venv (Claude Code запускает MCP-сервер отдельным процессом и НЕ наследует активированный venv): на Windows — .venv\Scripts\python.exe, на Linux VPS — .venv/bin/python. Затем в Claude Code вызови инструменты mcp__gmail__list_unread_batch и т.д.
This server cannot be deployed
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Email inboxes for AI agents: send, receive, reply, search, and manage threaded email over MCP.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Your agent needs a mailbox of its own — to receive, thread, draft and send, with attachments, without borrowing your personal inbox or your company's SMTP. **What you can ask for** • "Create an inbox for this agent and tell me its address." • "Read the new messages in this thread and draft a reply." • "Send this message with the attachment and wait for the response." • "Search this inbox for everything from that domain." • "Show delivery metrics and the events on this inbox." **How to use it** Point any MCP client at https://mcp.aisa.one/mail/mcp and sign in with OAuth — there is no key to create or paste. 49 tools: create and delete inboxes, list and read messages, raw message bodies, attachments, threads, drafts and draft attachments, send and reply, message search, inbox events, metrics, and list entries — reads and writes. **Why this rather than the source** A real inbox an agent owns, rather than an SMTP credential it borrows from a human. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Find the contact elsewhere in the catalogue, then write to them from here — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/sales/mcp finds the person to write to.
