Skip to main content
Glama
Sign In
deenesjakoptruzh
Gmail Guardian

Gmail Guardian

by wyller
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Gmail Guardian

Gmail管理のためのインテリジェントエージェント。Claude（Anthropic SDK）で構築され、MCPサーバーを介して統合されています。

機能

スキル

説明

triagem-email

未読メールをカテゴリと優先度で分類します

classificar-newsletters

ニュースレターをテーマ別に識別・整理します

limpar-promocoes

セーフガード付きでプロモーションメールを一括アーカイブします

resumir-importantes

アクション項目と期限を含むブリーフィングを生成します

sugerir-filtros

パターンを分析し、自動フィルタを作成します

responder-rascunho

保留中のメールに対する下書き返信を生成します

auditoria-acoes

ロールバック対応の完全なアクションログ

Related MCP server: Gmail MCP Server

前提条件

  • Python 3.11+

  • Gmail付きのGoogleアカウント

  • Anthropic APIキー

  • Google Cloud ConsoleのOAuth2認証情報

インストール

# 1. Instalar dependências
pip install -r requirements.txt

# 2. Configurar variáveis de ambiente
cp .env.example .env
# Editar .env com suas chaves

# 3. Baixar credentials.json do Google Cloud Console
# (APIs & Services > Credentials > OAuth 2.0 Client IDs)
# Salvar em config/credentials.json

使用方法

対話モード（REPL）

python run.py
Gmail Guardian — Agente de gerenciamento de emails
Digite 'sair' para encerrar | 'log' para ver auditoria

Você: triar meus emails não lidos
Agente: Buscando emails não lidos...

MCPサーバーとして（Claude Code）

python run.py --mcp

~/.claude/settings.jsonに追加:

{
  "mcpServers": {
    "gmail": {
      "command": "python",
      "args": ["/caminho/para/email-guardian/run.py", "--mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "GOOGLE_CREDENTIALS_PATH": "/caminho/para/credentials.json"
      }
    }
  }
}

その後、Claude Codeで使用:

/triagem-email
/limpar-promocoes
/resumir-importantes

プロジェクト構造

email-guardian/
├── .claude/              # Configuração do agente e skills para Claude Code
│   ├── agents/           # Definição do agente gmail-guardian
│   └── skills/           # Skills invocáveis via /skill-name
├── agent/                # Orquestração do agente (Anthropic SDK)
├── gmail_mcp/            # MCP Server + ferramentas Gmail
│   ├── services/         # Wrappers da Gmail API
│   ├── tools/            # Implementação das ferramentas MCP
│   └── schemas/          # Dataclasses para tipagem
├── config/               # Settings, políticas e categorias
├── tests/                # Testes unitários
├── .env.example          # Template de variáveis de ambiente
├── requirements.txt
└── run.py                # Entry point

セキュリティ

  • 明示的な確認なしにメールを完全に削除することはありません

  • 注文確認や請求書は自動的に保持されます

  • すべてのアクションは監査ログに記録されます

  • DRY_RUN=trueで変更を加えずにシミュレーション可能

テスト

pytest tests/ -v

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • Gmail MCP Server

    JBR90
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to manage Gmail by reading unread emails with automatic classification, creating AI-generated draft replies, and saving drafts directly to Gmail through the Gmail API.
    119 npm
    MIT

  • Gmail MCP Server

    kushal45
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides comprehensive Gmail integration with 25+ tools for intelligent email management, including AI-powered categorization, advanced search and filtering, automated archiving and cleanup, analytics, and secure OAuth2 authentication.
    119 npm
    2
    MIT

  • Email Triage MCP

    claw-factory
    A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI agents to interact with Gmail for classifying messages, extracting action items, and performing batch inbox triage. It supports automated labeling, smart replies, and task creation for external platforms like Linear, Jira, and Todoist.
    -

  • Gmail MCP Server

    TechVest-Global
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI-powered email management through Gmail, including search, send, drafts, labels, and an intelligent agent with human approval workflow and optional customer database integration.
    -