Gmail Guardian
Gmail Guardian
智能 Gmail 管理助手,基于 Claude(Anthropic SDK)构建并通过 MCP 服务器集成。
功能
技能 | 描述 |
| 按类别和优先级对未读邮件进行分类 |
| 按主题识别并整理新闻简报 |
| 批量归档促销邮件并附带保护措施 |
| 生成包含行动点和截止日期的简报 |
| 分析模式并创建自动过滤器 |
| 为待处理邮件生成回复草稿 |
| 完整操作日志并支持撤销 |
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.pyGmail 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/ -vTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Search and triage all your mailboxes; draft replies and campaigns; send only as you allow.
Gmail, Outlook, Drive, OneDrive and calendars for AI agents. Many accounts, one endpoint, audit log.
Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- FlicenseNot gradedqualityDmaintenanceProvides 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-
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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.-
- FlicenseNot gradedqualityDmaintenanceEnables AI-powered email management through Gmail, including search, send, drafts, labels, and an intelligent agent with human approval workflow and optional customer database integration.-