Skip to main content
Glama
Gmail Guardian

Gmail Guardian

by wyller

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      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.
      -
    • F
      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.
      2
      -
    • 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.
      -
    • 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.
      -