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

ActivityInactive
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.
    150 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.
    150 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.
    -