Modular IMAP proxy (including PyCIRCLeanMail and MISP forward modules)
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.

Modular Python IMAP proxy

Build Status


Integrated modules

Modules are easy to integrate and to remove (just remove their calls in the file).

  • Sanitize emails and keep a copy in a Quarantine folder using the PyCIRCLeanMail
  • Forward emails to MISP

Installation and run

Demonstration with PyCIRCLeanMail


git clone
cd IMAP-Proxy
python3 install
pip3 install -r requirements.txt

Run the proxy

It can be started by adding arguments to the command line: -h

Or it can be started with the configuration file imapproxy.conf:

Run with Thunderbird

First, open Thunderbird, right-click on your email address and select "Settings". In "Server Settings", modify the "Server Name" by the IP address of the proxy (or localhost).

How to contribute

Any help is welcome via pull requests and Issues or by contacting contributors of this project. Thank you !


    Copyright (C) 2018 Xavier Schul
    Copyright (C) 2018 CIRCL - Computer Incident Response Center Luxembourg (c/o smile, security made in Lëtzebuerg, Groupement d'Intérêt Economique)

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation, either version 3 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program.  If not, see <>.