Outlook MCP Server

🤖 Outlook MCP Server

Gerenciamento de e-mail com IA para Microsoft Outlook - Pesquise, componha, organize e encaminhe e-mails em lote com comandos de linguagem natural.

🤔 Escolha do Projeto: Abordagem Local vs Nuvem

Este projeto usa win32COM que funciona inteiramente localmente com seus dados do Outlook (mais seguro), enquanto nosso novo Microsoft Graph MCP Server fornece acesso online ao ecossistema completo do Microsoft 365 (mais recursos). Escolha com base em suas necessidades de segurança e funcionalidade.

Por que Escolher Este Projeto (win32COM)?

• ✅ Processamento Local de Dados: Todas as operações de e-mail acontecem localmente no seu computador - nenhum dado sai da sua máquina
• ✅ Segurança Aprimorada: Nenhuma autenticação em nuvem ou tokens de API necessários - funciona com sua configuração existente do Outlook
• ✅ Capacidade Offline: Acesse e gerencie e-mails mesmo sem conexão com a internet
• ✅ Privacidade em Primeiro Lugar: Seus dados de e-mail nunca tocam servidores externos ou serviços em nuvem

Por que Mudar para a API do Microsoft Graph?

• ✅ Ecossistema Completo do Microsoft 365: Acesse E-mail, Calendário, Teams, OneDrive, SharePoint
• ✅ Suporte Multiplataforma: Funciona em Windows, macOS, Linux e dispositivos móveis
• ✅ Autenticação Moderna: OAuth 2.0 com fluxo de código de dispositivo
• ✅ Desempenho em Escala de Nuvem: Sem dependências de aplicativos locais
• ✅ Acesso Online: Funciona diretamente com os serviços do Microsoft 365 baseados em nuvem

---

🚀 Início Rápido (2 Minutos)

O Que Você Vai Obter

• Pesquisa Inteligente de E-mails: "Encontre e-mails sobre aprovação de orçamento da semana passada"
• Escrita de E-mails com IA: Redija respostas com sugestões contextuais
• Organização Facilitada: Crie pastas e mova e-mails com comandos simples
• Encaminhamento em Lote: Envie e-mails para centenas de destinatários em minutos, não horas

🤖 Comportamento e Fluxo de Trabalho da IA

O agent_prompt_template.md define como o assistente de IA se comporta ao gerenciar e-mails:

• Propósito: Guiar o fluxo de trabalho da IA para pesquisa, resumo e redação de e-mails
• Regras Principais: Lógica AND para pesquisas, exibição de e-mails 5 por 5, confirmação antes do envio
• Segurança: Restrições integradas garantem controle do usuário e previnem ações não autorizadas
• Como Usar: Copie o conteúdo do template e use-o para configurar seu assistente de IA

Consulte o template para diretrizes completas de comportamento e definições de fluxo de trabalho

Por que Escolher o Outlook MCP Server?

Recurso	Outlook MCP Server	Outlook Tradicional	Suplementos do Outlook
Pesquisa de E-mail com IA	✅ "Encontre e-mails urgentes do meu chefe"	❌ Navegação manual por pastas	⚠️ Apenas pesquisa básica
Linguagem Natural	✅ "Mostre-me e-mails de orçamento da semana passada"	❌ Filtros complexos necessários	⚠️ Palavras-chave limitadas
Encaminhar 100+ E-mails em Lote	✅ 2 minutos com CSV	❌ 50+ minutos manualmente	⚠️ 20+ minutos
Escrita de E-mail com IA	✅ Respostas contextuais	❌ Composição manual	⚠️ Templates básicos
Tempo de Configuração	✅ 2 minutos	✅ Já instalado	❌ 10-30 minutos
Privacidade	✅ 100% processamento local	✅ Apenas local	⚠️ Dependente de nuvem
Custo	✅ Completamente gratuito	✅ Incluído	💰 R$ 5-50/mês
Curva de Aprendizado	✅ Linguagem natural	✅ Interface familiar	⚠️ Nova interface

Impacto no Mundo Real

Antes: "Preciso encaminhar este e-mail para 150 membros da equipe..."

• Manual: Clicar em Encaminhar → Digitar cada e-mail → Enviar → 2+ horas perdidas
• Outlook Tradicional: Criar lista de distribuição → Adicionar membros → Encaminhar → 30+ minutos

Depois: "Encaminhe este e-mail para todos em team.csv"

• Outlook MCP Server: Carregar CSV → IA encaminha para todos → 2 minutos no total
• Tempo Economizado: 48+ minutos por operação em lote!

Requisitos

• ✅ Python 3.8+
• ✅ Microsoft Outlook 2016+ (deve estar em execução)
• ✅ Windows 10+

Instalação e Configuração

Método 1: UVX (Recomendado - Dependências Automáticas)

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
uvx --with "pywin32>=226" --with-editable "." outlook-mcp-server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": ["--with", "pywin32>=226", "--with-editable", ".", "outlook-mcp-server"]
    }
  }
}

Método 2: Python Padrão

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt
python -m outlook_mcp_server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["-m", "outlook_mcp_server"]
    }
  }
}

Método 3: Código-Fonte Direto (Desenvolvimento)

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["C:\\Project\\outlook-mcp-server\\outlook_mcp_server\\__main__.py"]
    }
  }
}

Teste Sua Configuração ✅

Pergunte ao seu assistente de IA: "Mostre-me meus e-mails recentes" - se funcionar, você está pronto!

Solução de Problemas de Configuração 🛠️

Problemas Comuns e Soluções:

Problema	Verifique Isto	Solução
"uvx not found"	O UV está instalado?	pip install uv e tente novamente
"python not found"	Python no PATH?	Use o caminho completo como C:\Python39\python.exe
"Outlook not running"	A janela do Outlook está aberta?	Inicie o Outlook primeiro e reinicie o MCP
"Permission denied"	Direitos de administrador?	Execute o terminal como administrador
"Module not found"	Dependências instaladas?	pip install -r requirements.txt

Verificação de Configuração:

# Test your setup before connecting to AI
python -c "import outlook_mcp_server; print('✅ Server module loaded')"

# Test Outlook connection (Windows only)
python -c "import win32com.client; outlook = win32com.client.Dispatch('Outlook.Application'); print('✅ Outlook connected')"

Configuração Específica por Cliente MCP:

Claude Desktop:

1. Abra as configurações do Claude Desktop
2. Encontre a seção "MCP Servers"
3. Clique em "Add Server" → "Custom"
4. Cole a configuração JSON
5. Reinicie o Claude Desktop

Outros Clientes MCP:

• Procure por "MCP Configuration" ou "Server Settings"
• Adicione o JSON ao arquivo de configuração do seu cliente
• Geralmente localizado em: ~/.config/[client]/mcp.json

Ainda Com Dúvidas? Reporte um problema com sua mensagem de erro e detalhes da configuração.

🎯 Recursos Principais

Gerenciamento de E-mails

• Pesquisa: Encontre e-mails por assunto, remetente, conteúdo ou intervalo de datas
• Composição: Escreva novos e-mails com assistência de IA
• Resposta: Respostas inteligentes que entendem o contexto da conversa
• Encaminhamento em Lote: Envie e-mails para centenas de destinatários a partir de arquivos CSV (economiza horas!)

Gerenciamento de Pastas

• Listar: Veja todas as suas pastas do Outlook
• Criar: Crie novas pastas com comandos simples
• Mover: Organize e-mails entre pastas
• Excluir: Remova pastas (cuidado - isto é permanente!)

📧 Encaminhamento em Lote: Economize Horas na Distribuição de E-mails

Casos de Uso no Mundo Real

🎯 Atualizações de Equipe

• Encaminhe relatórios semanais para toda a sua equipe
• Envie atualizações importantes para todos os membros da equipe
• Distribua atualizações de projetos para partes interessadas

📊 Campanhas de Marketing

• Envie newsletters para listas de assinantes
• Encaminhe e-mails promocionais para segmentos de clientes
• Distribua convites de eventos para grupos de contatos

🏢 Comunicações Corporativas

• Envie atualizações de políticas para todos os funcionários
• Encaminhe materiais de treinamento para departamentos
• Distribua anúncios para listas de distribuição da empresa

🔄 Como Funciona

Fluxo de Trabalho Simples

1. Carregue e-mails: "Mostre-me e-mails recentes" → Os e-mails aparecem no cache
2. Navegue pelos resultados: Veja 5 e-mails por página com formatação clara
3. Aja: Responda, mova, exclua ou obtenha um resumo com IA
4. Confirme antes de enviar: A IA sempre pede confirmação antes de enviar e-mails

Comportamento do Assistente de IA

• Entende linguagem natural: "Encontre e-mails urgentes do meu chefe"
• Mostra resumos de e-mails: Visão geral em uma linha + principais itens de ação
• Redige com contexto: Respostas entendem a conversa
• Nunca envia sem permissão: Sempre confirma antes de enviar

Fluxo de Trabalho de Encaminhamento em Lote

1. Prepare Seu Arquivo CSV

email
john@company.com
jane@company.com
team@company.com

2. Use Linguagem Natural

"Forward this email to everyone in my contacts.csv"
"Send this project update to my team list"
"Distribute this newsletter to subscribers.csv"

3. A IA Cuida do Resto

• Divide automaticamente listas grandes (máx. 500 por lote)
• Envia via BCC para proteger a privacidade dos destinatários
• Adiciona sua mensagem personalizada antes do e-mail original
• Fornece confirmação de entrega

Economia de Tempo

Encaminhamento manual: 100 e-mails × 30 segundos = 50 minutos Encaminhamento em lote: 30 segundos de configuração + 2 minutos de processamento = 2,5 minutos Você economiza: 47,5 minutos por lote!

🔧 Comandos Comuns

Experimente com seu assistente de IA:

"Show me emails from last 3 days"
"Find emails about project updates" 
"Draft a reply to John about rescheduling"
"Create a folder called 'Work Projects'"
"Move email #3 to the Archive folder"

🛠️ Ferramentas Essenciais

Pesquisa e Carregamento de E-mails

• list_recent_emails_tool(days=7) - Carregar e-mails recentes (máx.: 30 dias)
• search_email_by_subject_tool("search term") - Pesquisar assuntos de e-mails
• search_email_by_sender_name_tool("sender name") - Pesquisar por remetente
• search_email_by_body_tool("search term") - Pesquisar conteúdo de e-mails (mais lento)

Ações de E-mail

• view_email_cache_tool(page=1) - Navegar pelos e-mails carregados (5 por página)
• get_email_by_number_tool(email_number) - Obter detalhes completos do e-mail
• reply_to_email_by_number_tool(email_number, "reply text") - Responder e-mail
• compose_email_tool("recipient@email.com", "subject", "body") - Enviar novo e-mail

Operações de Pastas

• get_folder_list_tool() - Sempre use primeiro para ver as pastas disponíveis
• create_folder_tool("folder name") - Criar nova pasta
• move_email_tool(email_number, "target folder") - Mover e-mail entre pastas
• move_folder_tool("source", "target") - Mover pastas

Notas de Segurança

• Sempre verifique a lista de pastas primeiro antes de mover/excluir
• E-mails são armazenados em cache - use os números do cache para operações
• Nunca envia sem confirmação - A IA sempre pergunta antes de enviar

⚡ Desempenho

• Carrega 100 e-mails em ~2 segundos
• Pesquisas concluídas em tempo real
• Todo o processamento acontece localmente (seus dados permanecem privados)

✅ Qualidade e Confiabilidade

Sistema Robusto de Validação

• Validação de Entrada: Todas as entradas do usuário são validadas antes do processamento
• Mensagens de Erro Personalizadas: Mensagens de erro claras e acionáveis para problemas comuns
• Verificações de Segurança: Impede operações inválidas antes que causem problemas

Testes Abrangentes

• 145+ Testes Unitários: Cada recurso é testado minuciosamente
• Cobertura de Configuração: Todas as configurações e constantes são validadas
• Tratamento de Casos Extremos: Testado contra entradas e cenários incomuns
• Qualidade Contínua: Testes executados a cada alteração para garantir confiabilidade

O Que Isso Significa Para Você

• Menos Erros: A validação detecta erros antes que causem problemas
• Melhores Mensagens de Erro: Saiba exatamente o que deu errado e como corrigir
• Operação Confiável: Testes abrangentes garantem desempenho consistente
• Operações Seguras: Salvaguardas integradas previnem perda acidental de dados

🛡️ Privacidade e Segurança

• 100% Processamento Local: Nenhum dado sai do seu computador
• Sem Serviços em Nuvem: Funciona inteiramente offline
• Seguro por Design: Usa sua instalação existente do Outlook

📚 Precisa de Ajuda?

• Verifique o template de prompt do agente para configuração do assistente de IA
• Consulte exemplos de configuração para diferentes métodos de instalação
• Leia a comparação Win32COM vs Graph API para detalhes técnicos
• Revise o guia de implementação da API Win32COM para otimização de desempenho
• Reporte problemas no repositório GitHub

---