IMAP MCP

Um servidor IMAP Model Context Protocol (MCP) para expor operações IMAP como ferramentas para assistentes de IA.

Documentação

imap-mcp

📧 Um servidor IMAP Model Context Protocol (MCP) para expor operações IMAP como ferramentas para assistentes de IA.

MIT License code style: prettier MCP Compatible semantic-release: angular

✨ Recursos

  • Criação de Rascunhos de E-mail: Crie rascunhos de e-mail que são salvos na pasta de rascunhos do seu servidor IMAP
  • Integração IMAP: Conecte-se a qualquer servidor de e-mail compatível com IMAP (Gmail, Outlook, etc.)
  • Autenticação Segura: Usa variáveis de ambiente para gerenciamento seguro de credenciais
  • Compatível com MCP: Funciona com Claude e outros assistentes de IA que suportam o Model Context Protocol
  • TypeScript: Suporte completo a TypeScript com definições de tipos adequadas

Configuração

{
  "mcpServers": {
    ...,
    "imap": {
      "command": "npx",
      "args": [
        "imap-mcp"
      ],
      "env": {
        "IMAP_HOST": "<IMAP host>",
        "IMAP_PORT": "<IMAP port>",
        "IMAP_USERNAME": "<IMAP username>",
        "IMAP_PASSWORD": "<IMAP password>",
        "IMAP_USE_SSL": "<true or false>"
      }
    }
  }
}

Uso

  1. Compile TypeScript para JavaScript:
npx tsc
  1. Execute o servidor MCP:
node dist/index.js

Ferramentas Disponíveis

create-draft

Cria uma mensagem de rascunho de e-mail e a salva na pasta de rascunhos do servidor IMAP.

Parâmetros:

  • to (string, obrigatório): O endereço de e-mail do destinatário
  • subject (string, obrigatório): A linha de assunto do e-mail
  • body (string, obrigatório): O conteúdo do corpo do e-mail
  • from (string, opcional): O endereço de e-mail do remetente (padrão: IMAP_USERNAME)

Exemplo:

{
  "to": "recipient@example.com",
  "subject": "Meeting Reminder",
  "body": "Don't forget about our meeting tomorrow at 2 PM.",
  "from": "sender@example.com"
}

A ferramenta tentará salvar o rascunho na pasta "INBOX.Drafts" ou "Drafts", dependendo da estrutura de pastas do seu servidor de e-mail.

Licença

MIT