Milkman — Privacy-First API Client
Milkman is a free, open-source desktop API client built on Java, designed for developers who care about data privacy. It stores all request data locally, sends zero telemetry, requires no account, and never touches a cloud server. An extensible, multi-protocol alternative to Postman for privacy-conscious developers and regulated environments.
What is Milkman?
Milkman was created by Florian Enner as a privacy-respecting API client after growing concerns about cloud-synced API tools handling sensitive credentials and request data. It is built in Java with a JavaFX UI, making it lightweight and cross-platform. All collections and environments are stored as local files — nothing is ever uploaded to any external server.
What makes Milkman particularly distinctive is its plugin architecture. Rather than supporting a fixed set of protocols, Milkman provides a core plugin host and each protocol (REST, GraphQL, gRPC, WebSocket, SQL) is a separate JAR plugin. This makes it unusually extensible: adding a new protocol is as simple as dropping a plugin file into the plugins directory and restarting the application.
Key Features
- Zero telemetry — no analytics, no usage tracking, no data sent to any external server
- No account required — install and use immediately; no registration, no email, no subscription
- Plugin system — REST, GraphQL, WebSocket, gRPC, SQL, JavaScript, Git plugins available
- Environment variables — named environments with key-value variables, switchable per request
- Request history — local request history with search; all data stored on disk
- Collections — organize requests into workspaces and collections stored as local files
- Import/export — import from Postman collections (JSON format)
- GraphQL — schema introspection and query editor via GraphQL plugin
- gRPC — unary and streaming gRPC calls via gRPC plugin with .proto file support
- Scripting — pre/post-request JavaScript scripts via the JavaScript plugin
- Cross-platform — Windows, macOS, Linux; requires Java 11+
Installation
Download (all platforms)
Download installer from milkman.dev Requires Java 11+ (get from adoptium.net)
Check Java version
java -version # Should show 11.x or higher
Install a plugin
# Download plugin JAR from GitHub releases # Place in: ~/.milkman/plugins/ # Restart Milkman to activate the plugin
Available Plugins
| Plugin | Protocol / Feature | Notes |
|---|---|---|
| milkman-rest | HTTP / HTTPS REST | Core plugin, bundled by default |
| milkman-graphql | GraphQL queries and mutations | Schema introspection support |
| milkman-grpc | gRPC (unary + streaming) | Proto file or server reflection |
| milkman-websocket | WebSocket connections | Send and receive messages |
| milkman-sql | SQL database queries | JDBC-based, any SQL database |
| milkman-scripting | Pre/post-request JavaScript | Dynamic request manipulation |
| milkman-git-sync | Git workspace sync | Commit collections directly from app |
Milkman vs Bruno vs Postman
| Feature | Milkman | Bruno | Postman |
|---|---|---|---|
| Telemetry | None | None | Yes |
| Account required | No | No | Yes |
| gRPC support | Yes (plugin) | Experimental | Yes |
| Git-friendly collections | Via git-sync plugin | Native (.bru files) | Export only |
| Runtime | Java 11+ | Electron | Electron |
| SQL queries | Yes (plugin) | No | No |
Use Cases
- API development in regulated industries (healthcare, finance, government) where cloud data policies prohibit third-party sync
- Testing gRPC services with the milkman-grpc plugin and .proto reflection
- Developers who need a single tool for REST, GraphQL, WebSocket, gRPC, and SQL queries
- Teams migrating away from Postman who want a privacy-respecting alternative with zero cloud dependency
- Secure environments (air-gapped networks, VPNs) where external API calls from the tool itself are not permitted
- Postman collection import for quick migration of existing request libraries
Frequently Asked Questions
How does Milkman compare to Postman?▼
Milkman is a privacy-first, open-source desktop API client with zero telemetry, no account requirement, and no cloud dependency — all data stays on your local machine. Postman is a commercially operated product that requires an account, stores collections in the cloud, and collects usage telemetry. Milkman is built in Java and runs on any platform with Java 11+. Postman is Electron-based. Milkman's plugin architecture allows extending it with support for many protocols beyond REST, whereas Postman's extensibility is more limited. The trade-off is that Milkman has a smaller community and fewer built-in integrations than Postman.
What plugins are available for Milkman?▼
Milkman has a rich plugin ecosystem. Core plugins include: REST (HTTP/HTTPS requests), GraphQL, WebSocket, gRPC, SQL (execute queries against databases), JavaScript (run scripts), Git (commit and push from inside Milkman), and Cassandra. Community plugins extend it further. Plugins are JAR files placed in the plugins directory. Each plugin adds a new request type — for example, the WebSocket plugin adds a WebSocket connection tab, the gRPC plugin adds support for protobuf services. This makes Milkman unusually versatile for a desktop API client.
Why would a developer choose a privacy-first API client?▼
API clients regularly handle sensitive data: production credentials, authentication tokens, API keys, PII in request/response bodies, and internal endpoint URLs. Tools that sync this data to the cloud or collect telemetry create a potential data leakage surface. Regulated industries (healthcare, finance, government) often have policies that prohibit sending API request data to third-party cloud services. Privacy-first tools like Milkman and Bruno store everything locally with no outbound data transmission, making them compliant with strict data handling requirements and eliminating the risk of credentials being exposed via a vendor's cloud infrastructure.
How does Milkman handle environment variables?▼
Milkman supports named environments, each containing a set of key-value variable pairs. Switch between environments (development, staging, production) from the environment dropdown. Variables are referenced in request URLs, headers, and body using double-curly brace syntax. Environments are stored as local files and can be imported/exported for sharing with teammates via Git or file share without involving any cloud service. Secret values in environments are masked in the UI to prevent accidental exposure.
Does Milkman support GraphQL and gRPC?▼
Yes, both via plugins. The GraphQL plugin provides a dedicated query editor with schema introspection support — Milkman can fetch the schema from a GraphQL endpoint and display it for reference. The gRPC plugin supports unary, server-streaming, client-streaming, and bidirectional-streaming calls. You provide the .proto file or a reflection-enabled endpoint, define the request message, and execute the call. Both plugins are maintained as part of the Milkman plugin ecosystem and are available in the official releases.
What are the system requirements for Milkman?▼
Milkman requires Java 11 or higher. It is distributed as a platform-specific installer for Windows (installer and portable ZIP) and macOS, and as a cross-platform JAR for Linux. On most systems you can check your Java version with java -version. If Java is not installed, adopt OpenJDK from adoptium.net — it is free and open-source. Milkman itself is open-source under the MIT license and available at milkman.dev. It has modest hardware requirements and runs well on older machines.
Related Products
on GumroadAPI Testing Cheatsheet Pack
Quick-reference cheatsheets for REST, GraphQL, and WebSocket testing. Includes Postman collections, shell scripts for smoke tests and load tests, and JWT decoder.
Buy on Gumroad →DevToolkit Starter Kit
A ready-to-deploy developer tools website with 12 built-in tools. Astro + Preact + Tailwind. Deploy to Cloudflare Pages for free. Built-in SEO, dark mode, and ad-ready layout.
Buy on Gumroad →TypeScript Quick Reference Toolkit
5 practical reference files for TypeScript developers: cheatsheet, TS vs JS comparison, 20 utility types with real examples, tsconfig best practices template, and 15 common mistakes guide. Print it. Keep it on your desk.
Buy on Gumroad →You Might Also Need
GraphQL Query Builder
Build GraphQL queries visually from your schema SDL. Select root fields, pick sub-fields, add arguments, and generate query/mutation/subscription strings instantly. Supports nested types.
Open free tool →
OpenAPI Validator
Paste your OpenAPI 3.x spec (YAML or JSON) to validate structure, find missing required fields, detect duplicate paths, check for missing operationIds, and get errors and warnings with path references.
Open free tool →
HTTP Status Code Reference
Complete HTTP status code reference. Search all 1xx, 2xx, 3xx, 4xx, and 5xx codes with plain-English descriptions, real-world use cases, and when to use each in REST APIs.
Open free tool →
More Free Tools
Related Articles
curl 深度使用手冊:API 測試從入門到進階
curl 是每位開發者必備的 CLI 工具。本文涵蓋 GET/POST/PUT/DELETE 請求、認證、header 設定、檔案上傳、除錯技巧,以及 REST API 測試的完整實戰範例。
GraphQL Federation vs REST Microservices: Which Architecture in 2026?
Compare GraphQL Federation vs REST microservices — Apollo Federation, schema stitching, performance, team scaling, migration paths, and when to choose each in 2026.
GraphQL vs REST vs gRPC: A 2026 API Design Comparison
A practical guide comparing GraphQL vs REST vs gRPC for modern API development. Covers performance, type safety, tooling, use cases, and a decision framework for 2026.
tRPC vs GraphQL vs REST: Type-Safe APIs in 2026
Compare tRPC, GraphQL, and REST for building type-safe APIs in 2026. Covers DX, performance, bundle size, schema management, and when to use each approach.
10 Best Free API Testing Tools in 2025 (Postman Alternatives Included)
Best free API testing tools in 2025: Postman free tier, Bruno, Insomnia, Hoppscotch, HTTPie, Thunder Client, and more. Full feature comparison included.
Enjoying this tool? Get more like it.
Weekly developer tool guides, productivity playbooks & AI tricks. Free. No spam.
Unlock AI-Powered Dev Tools
- ⚡ AI Code Review, Doc Generator & SQL Builder
- ⚡ All premium templates & early access
- ⚡ Member discounts on Gumroad products
$9/mo after trial · Cancel anytime
Want the full toolkit?
Get DevPlaybook Pro
Every template, guide, boilerplate, and automation script in one bundle. 13 premium products — grab them all at once and save big.
MIT licensed · Instant download · No subscription
See what's included → Browse all deals →