Skip to main content
Glama
staschatwork

gmail-sorter

by staschatwork
OverviewSchemaRelated ServersScoreDiscussions
Python
Hybrid

gmail-sorter

Система сортировки личного 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]"

Тесты (работают офлайн, без Gmail-кредов)

python -m pytest

Инициализация state.db

БД создаётся автоматически при старте MCP-сервера. Вручную:

python -c "import sys; sys.path.insert(0,'mcp'); import db; db.init_db('data/state.db'); print('ok')"

OAuth (разово, требует client_secret из Google Cloud)

# Положи скачанный client_secret в .gmail-credentials.json (см. .env.example)
python mcp/google_auth.py            # откроет браузер, сохранит .gmail-token.json

Создание меток Gmail (разово, после OAuth)

python scripts/setup_labels.py

Запуск MCP-сервера через Claude Code

Скопируй .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 и т.д.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • mcp-gmail

    ustikya
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides a suite of 17 tools for searching, reading, sending, and managing Gmail messages and drafts through the Model Context Protocol. It enables comprehensive email management including label organization, archiving, and attachment handling directly within MCP-compatible clients like Claude.
    49
    2
    Apache 2.0

  • multi-gmail-mcp

    gx-55
    A
    license
    Not graded
    quality
    C
    maintenance
    Lets Claude Desktop manage multiple Gmail accounts simultaneously, supporting search, read, send, reply, and label organization via MCP tools.
    86
    19
    MIT

  • workspace-ai

    faizansid3
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to interact with Gmail accounts via MCP, providing tools for listing labels, searching, reading, drafting, and sending emails with OAuth2 authentication.
    -

  • email-agent-mcp-server

    Ali-Zia3500
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI-powered Gmail triage: fetches unread emails, classifies them, drafts replies for important ones, and sends only after user approval via conversational review. Exposes tools for checking unread emails and submitting review feedback from Claude Desktop or any MCP client.
    -

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/staschatwork/gmail-sorter'

If you have feedback or need assistance with the MCP directory API, please join our Discord server