screenshot of mitmproxy's interface

mitmproxy is a free and open source interactive HTTPS proxy.


Release Notes (v4.0) – Other Downloads

Command Line
Web Interface
Python API
screenshot of mitmproxy's interface

Command Line

mitmproxy is your swiss-army knife for debugging, testing, privacy measurements, and penetration testing. It can be used to intercept, inspect, modify and replay web traffic such as HTTP/1, HTTP/2, WebSockets, or any other SSL/TLS-protected protocols. You can prettify and decode a variety of message types ranging from HTML to Protobuf, intercept specific messages on-the-fly, modify them before they reach their destination, and replay them to a client or server later on.

screenshot of mitmweb's interface

Web Interface

Use mitmproxy's main features in a graphical interface with mitmweb. Do you like Chrome's DevTools? mitmweb gives you a similar experience for any other application or device, plus additional features such as request interception and replay.

addon.py
from mitmproxy import http

def request(flow: http.HTTPFlow):
    # redirect to different host
    if flow.request.pretty_host == "example.com":
        flow.request.host = "mitmproxy.org"
    # answer from proxy
    elif flow.request.path.endswith("/brew"):
    	flow.response = http.HTTPResponse.make(
            418, b"I'm a teapot",
        )

Python API

Write powerful addons and script mitmproxy with mitmdump. The scripting API offers full control over mitmproxy and makes it possible to automatically modify messages, redirect traffic, visualize messages, or implement custom commands.

Latest Tweets

Powerful Ecosystem

Mitmproxy powers a number of notable open-source projects:

  • pathod, mitmproxy's sister project to craft malformed HTTP/1, HTTP/2 and WebSocket requests.
  • netograph, a privacy analysis and measurement service.
  • tamper, a Chrome extension that lets you edit remote files locally.
  • bdfproxy, a BackDoorFactory integration to patch binaries with shell code on the fly.
  • mastermind, a project from ustwo that offers an easy way to mock an API or a website

Open Source

Mitmproxy is free and open source. Be part of the mitmproxy community and help improve your favorite HTTPS proxy.


GitHub Developer Chat Community Forums