---
id: mitmproxy-macos
version: "0.12.11"
license: MIT
license_treatment: permissive
maintenance: active
---

# mitmproxy-macos

License: permissive · Maintenance: active · Downloads: 165.3K/mo

## What it is and what it does

mitmproxy-macos is a companion package that bundles precompiled macOS applications needed for mitmproxy to intercept and inspect network traffic on macOS systems. It includes two main components: a Rust-based certificate-trusting helper app that marks the mitmproxy CA as trusted in the system keychain, and a macOS Network System Extension app bundle that handles traffic redirection at the network level.

The package is designed to be used alongside mitmproxy itself, providing the native macOS integration layer that allows mitmproxy to function as a system-wide proxy. It requires Python 3.12 or later and is maintained as part of the mitmproxy project. The package contains only precompiled binaries and has no Python runtime dependencies, making installation straightforward.

Use it for:

- Set up mitmproxy on macOS to intercept HTTPS traffic from applications for debugging or security testing
- Automate CA certificate installation on macOS systems running mitmproxy
- Configure system-wide traffic redirection for penetration testing or network analysis on macOS
- Develop network-level traffic inspection tools on macOS using the network extension framework

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides macOS-specific helper applications and network extension support for mitmproxy, including a certificate-trusting utility and traffic redirection app.

Yes, if you are running mitmproxy on macOS and need native system integration. The package is actively maintained, has no external dependencies, and uses a permissive MIT license. It is essential for mitmproxy's macOS functionality rather than optional, so the decision hinges on whether you need mitmproxy itself on that platform.

## Install

pip install mitmproxy-macos
uv add mitmproxy-macos
poetry add mitmproxy-macos

## Installing mitmproxy-macos

Before you install: Active maintenance with a recent release 25 days ago. Low install friction as a pure wheel package with no runtime dependencies. Requires Python 3.12 or later.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, suitable for both personal and commercial projects.

Quickstart:

pip install mitmproxy-macos==0.12.11

# Use with mitmproxy, setting env var for development:
export MITMPROXY_KEEP_REDIRECTOR=1

Requires Python 3.12 or later; macOS system only; paid Apple Developer Account needed for development of the network extension.

Verify before relying:

- Whether the precompiled binaries work on all recent macOS versions or have specific OS requirements
- Whether installation outside of the main mitmproxy package workflow is supported or recommended
- Performance or stability characteristics of the network extension under typical usage

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 165.3K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

macos mitmproxy integration, network traffic interception macos, certificate trust helper app, macos network extension, mitmproxy redirector setup, macos-native, network-interception, security-testing

[View on SkillFed](https://skillfed.io/packages/mitmproxy-macos) · [View on PyPI](https://pypi.org/project/mitmproxy-macos/)