Automação do Outlook via Rube MCP

Automatize operações do Microsoft Outlook através do toolkit Outlook da Composio via Rube MCP.

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Outlook via RUBE_MANAGE_CONNECTIONS com o toolkit outlook
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit outlook
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o Microsoft OAuth
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Pesquisar e Filtrar E-mails

Quando usar: O usuário deseja encontrar e-mails específicos em sua caixa de correio.

Sequência de ferramentas:

1. OUTLOOK_SEARCH_MESSAGES - Pesquisar com sintaxe KQL em todas as pastas [Obrigatório]
2. OUTLOOK_GET_MESSAGE - Obter detalhes completos da mensagem [Opcional]
3. OUTLOOK_LIST_OUTLOOK_ATTACHMENTS - Listar anexos de mensagens [Opcional]
4. OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT - Baixar anexo [Opcional]

Parâmetros principais:

• query: String de pesquisa KQL (de:, para:, assunto:, recebido:, temanexo:)
• from_index: Início da paginação (baseado em 0)
• size: Resultados por página (máximo 25)
• message_id: ID da mensagem (use hitId dos resultados da pesquisa)

Armadilhas:

• Funciona apenas com contas Microsoft 365/Enterprise (não @hotmail.com/@outlook.com)
• A paginação depende de hitsContainers[0].moreResultsAvailable; pare apenas quando for falso
• Use hitId dos resultados da pesquisa como message_id para chamadas subsequentes, não resource.id
• Latência do índice: e-mails muito recentes podem não aparecer imediatamente
• Imagens inline aparecem como anexos; filtre por mimetype para documentos reais

2. Consultar E-mails em uma Pasta

Quando usar: O usuário deseja listar e-mails em uma pasta específica com filtros OData.

Sequência de ferramentas:

1. OUTLOOK_LIST_MAIL_FOLDERS - Listar pastas de e-mail para obter IDs de pasta [Pré-requisito]
2. OUTLOOK_QUERY_EMAILS - Consultar e-mails com filtros estruturados [Obrigatório]

Parâmetros principais:

• folder: Nome da pasta ('inbox', 'sentitems', 'drafts') ou ID da pasta
• filter: Filtro OData (por exemplo, isRead eq false and importance eq 'high')
• top: Máximo de resultados (1-1000)
• orderby: Campo e direção de ordenação
• select: Array de campos a serem retornados

Armadilhas:

• QUERY_EMAILS pesquisa APENAS UMA pasta; use SEARCH_MESSAGES para pesquisa entre pastas
• Pastas personalizadas exigem IDs de pasta, não nomes de exibição; use LIST_MAIL_FOLDERS
• Sempre verifique response['@odata.nextLink'] para paginação
• Não é possível filtrar por destinatário ou conteúdo do corpo; use SEARCH_MESSAGES para isso

3. Gerenciar Eventos de Calendário

Quando usar: O usuário deseja listar, pesquisar ou inspecionar eventos de calendário.

Sequência de ferramentas:

1. OUTLOOK_LIST_EVENTS - Listar eventos com filtros [Opcional]
2. OUTLOOK_GET_CALENDAR_VIEW - Obter eventos em uma janela de tempo [Opcional]
3. OUTLOOK_GET_EVENT - Obter detalhes de eventos específicos [Opcional]
4. OUTLOOK_LIST_CALENDARS - Listar calendários disponíveis [Opcional]
5. OUTLOOK_GET_SCHEDULE - Obter informações de ocupado/livre [Opcional]

Parâmetros principais:

• filter: Filtro OData (use start/dateTime, NÃO receivedDateTime)
• start_datetime/end_datetime: ISO 8601 para visualização de calendário
• timezone: Fuso horário IANA (por exemplo, 'America/New_York')
• calendar_id: ID de calendário não primário opcional
• select: Campos a serem retornados

Armadilhas:

• Use apenas propriedades de eventos de calendário (start/dateTime, end/dateTime), NÃO propriedades de e-mail (receivedDateTime)
• A visualização de calendário requer start_datetime e end_datetime
• Eventos recorrentes precisam de expand_recurring_events=true para ver ocorrências individuais
• O status de recusa é por participante através de attendees[].status.response

4. Gerenciar Contatos

Quando usar: O usuário deseja listar, criar ou organizar contatos.

Sequência de ferramentas:

1. OUTLOOK_LIST_CONTACTS - Listar contatos [Opcional]
2. OUTLOOK_CREATE_CONTACT - Criar um novo contato [Opcional]
3. OUTLOOK_GET_CONTACT_FOLDERS - Listar pastas de contatos [Opcional]
4. OUTLOOK_CREATE_CONTACT_FOLDER - Criar pasta de contatos [Opcional]

Parâmetros principais:

• givenName/surname: Nome do contato
• emailAddresses: Array de objetos de e-mail
• displayName: Nome completo para exibição
• contact_folder_id: Pasta opcional para contatos

Armadilhas:

• A criação de contatos suporta muitos campos, mas apenas givenName ou surname é necessário

…