ClaudePost

Uma interface de gerenciamento de e-mail integrada, alimentada por Claude.

GitHub
114

Documentação

ClaudePost

Um servidor Model Context Protocol (MCP) que fornece uma interface de gerenciamento de e-mail integrada através do Claude. Esta integração permite que você lide com e-mails diretamente por meio de conversas em linguagem natural com o Claude, suportando recursos como busca, leitura e envio de e-mails com segurança.

Recursos e Demonstração

Busca e Leitura de E-mails

  • 📧 Busque e-mails por intervalo de datas e palavras-chave
  • 📅 Veja estatísticas diárias de e-mails
  • 📝 Leia o conteúdo completo do e-mail com suporte a threads

Composição e Envio de E-mails

  • ✉️ Envie e-mails com suporte a destinatários em cópia (CC)
  • 🔒 Tratamento seguro de e-mails com TLS

Pré-requisitos

  • Python 3.12 ou superior
  • Uma conta do Gmail (ou outro provedor de e-mail)
  • Se estiver usando o Gmail:
  • Aplicativo Claude Desktop

Configuração

  1. Instale o uv:

    # MacOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Remember to restart your terminal after installation

  2. Clone e configure o projeto:

    # Clone the repository
git clone https://github.com/ZilongXue/claude-post.git
cd claude-post

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

  3. Crie um arquivo .env na raiz do projeto:

    EMAIL_ADDRESS=your.email@gmail.com
EMAIL_PASSWORD=your-app-specific-password
IMAP_SERVER=imap.gmail.com
SMTP_SERVER=smtp.gmail.com
SMTP_PORT=587

  4. Configure o Claude Desktop:

    Primeiro, certifique-se de ter o Claude for Desktop instalado. Você pode instalar a versão mais recente aqui. Se você já tem o Claude for Desktop, certifique-se de que ele esteja atualizado para a versão mais recente.

    Abra o arquivo de configuração do Claude Desktop:

    # MacOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Create the file if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude
touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

    Adicione a seguinte configuração:

    {
  "mcpServers": {
    "email": {
      "command": "/Users/username/.local/bin/uv",
      "args": [
        "--directory",
        "/path/to/claude-post/src/email_client",
        "run",
        "email-client"
      ]
    }
  }
}

    Substitua /Users/username e /path/to/claude-post pelos seus caminhos reais.

    Após atualizar a configuração, reinicie o Claude Desktop para que as alterações tenham efeito.

Executando o Servidor

O servidor é executado automaticamente através do Claude Desktop:

  • O servidor iniciará quando o Claude for iniciado se estiver configurado corretamente
  • Nenhum gerenciamento manual do servidor é necessário
  • O servidor para quando o Claude é fechado

Uso Através do Claude

Você pode interagir com seus e-mails usando comandos em linguagem natural. Aqui estão alguns exemplos:

Buscar E-mails

  • "Mostre-me e-mails da semana passada"
  • "Encontre e-mails com assunto contendo 'reunião'"
  • "Busque e-mails de recruiting@linkedin.com entre 2024-01-01 e 2024-01-07"
  • "Busque e-mails enviados do mês passado"

Ler Conteúdo de E-mail

  • "Mostre-me o conteúdo do e-mail #12345"
  • "Qual é a mensagem completa do último e-mail do RH?"

Estatísticas de E-mail

  • "Quantos e-mails recebi hoje?"
  • "Mostre-me contagens diárias de e-mails da semana passada"

Enviar E-mails

Nota: Por razões de segurança, o Claude sempre mostrará os detalhes do e-mail para confirmação antes de realmente enviar.

Estrutura do Projeto

claude-post/
├── pyproject.toml
├── README.md
├── LICENSE
├── .env                    # Not included in repo
├── .python-version        # Python version specification
└── src/
    └── email_client/
        ├── __init__.py
        ├── __main__.py
        └── server.py       # Main implementation

Notas de Segurança

  • Use senhas específicas do aplicativo em vez da senha principal da sua conta
  • Para usuários do Gmail:
    1. Ative a Verificação em Duas Etapas na sua Conta do Google
    2. Gere uma Senha de Aplicativo para este aplicativo
    3. Use a Senha de Aplicativo no seu arquivo .env

Registro de Logs

O aplicativo registra informações detalhadas em email_client.log. Verifique este arquivo para informações de depuração e mensagens de erro.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.