Postmate Client — Privacy-First Postman Alternative for VS Code

Test REST, GraphQL, and WebSocket APIs directly inside VS Code. No cloud sync, no login, no telemetry — free forever.

Postmate Client is a local-first API client built natively into VS Code. Send REST and GraphQL calls, test WebSocket and WSS connections in real time, compare responses side-by-side, run data-driven CSV tests, and automate everything in CI/CD — without ever leaving your editor or sending your requests to someone else's servers.

If you've been paying for Postman or Thunder Client just for features they put behind a paywall — WebSocket testing, the CLI runner, data-driven testing — Postmate Client gives you all of it free.

Postmate Client overview — privacy-first Postman alternative running inside VS Code

Why developers choose Postmate Client

🔒 Privacy-first by design. No cloud sync, no login, no telemetry. Your requests, tokens, and payloads never leave your machine.
⚡ Native to VS Code. No separate desktop app to install or switch to — instant startup, lives in the same editor you write code in.
💸 Free forever. Every feature is free — WebSocket, CLI, data tables, response compare, GraphQL. No paid tiers, no team seats, no upsells.

What's new — OAuth 2.0 authentication

Postmate Client now speaks OAuth 2.0 natively — no more copy-pasting tokens from another tool:

Client Credentials and Password grants
Leave the token field empty and Postmate fetches a token automatically on Send — cached and reused until it's about to expire
Get New Access Token button for fetching and inspecting tokens manually
Client authentication via Basic Auth header or in the request body
{{variables}} and secrets work in every field — keep client secrets in your environment, not in the request
Works in the request panel, collection runner, pre-requests, and the CLI
Access tokens are never saved to disk — privacy-first, like everything else

Also recent: WebSocket and WSS testing as a first-class request type — connect, stream, and save ws:// requests alongside REST and GraphQL. Full WebSocket guide →

Features

REST, GraphQL, and WebSocket — one editor

A complete visual request builder with tabs for params, headers, body, auth, tests, and pre/post-request scripts. Authentication covers Basic, Bearer, API Key, AWS Signature, and OAuth 2.0 (with automatic token fetching). Build REST and GraphQL calls without writing boilerplate. Stream WebSocket connections in the same UI.

Postmate Client request builder — REST, GraphQL, and WebSocket in a native VS Code UI

Side-by-side response comparison

Fire two requests in parallel against different environments and instantly see every difference highlighted in clean JSONPath notation. Run single comparisons or bulk comparisons across CSV data tables — perfect for staging-vs-prod regression checks.

Side-by-side API response comparison with diff highlighting in Postmate Client

Single-row compare guide → · Bulk CSV compare guide →

Data tables and per-request tagging

Attach a CSV data table to any environment — automatically active across every request. Tag rows with a _dtag column to filter which rows run per request. Unique to Postmate Client.

Data tables in Postmate Client for data-driven API testing with CSV

Tests, assertions, and pm scripting

Write tests in plain English with the tabular test editor, or use the full pm scripting library for advanced assertions and chained workflows.

pm.test("Status is 200", () => {
  pm.expect(RESPONSE.status).to.equal(200);
});

pm.setVariable("token", RESPONSE.body.token);
pm.schemaTest("Validate response schema", userSchema, sampleData);

Available pm methods include pm.assert, pm.expect, pm.test, pm.getRequest, pm.getVariable, pm.setVariable, pm.clearVariable, pm.listVariables, pm.log, pm.schemaTest, and pm.base64Decode.

For data manipulation, the response body is exposed directly:

const resp = RESPONSE.body;
resp.students.forEach((s) => console.log(s.name));

Tests tab in Postmate Client showing tabular test editor for plain-English assertions

Import from anywhere

Bring your existing work in one click:

Postman v2.1 collections
OpenAPI 3.0 and Swagger 2.0 specs
cURL commands — paste any cURL and it parses into a full request (demo video)

Environments, variables, and request chaining

Manage dev, staging, and production with named environments. Reference values anywhere with {{variableName}} syntax. Chain requests visually to pass tokens, IDs, and computed values between calls.

Collection Runner with drag-and-drop sequencing

Run any folder or collection in sequence with a single click. Drag to reorder. Filter rows by tag. WebSocket requests are skipped automatically so they don't block your stateless HTTP run.

Collection Runner in Postmate Client

CLI for CI/CD

Run collections from the command line. Automate API tests in any pipeline. Generate HTML reports for stakeholders. The CLI is free — no paid tier, no Newman equivalent to license.

CLI reference →

Developer-friendly extras

Log as cURL — log any outgoing request as a cURL command instead of plain text
Pre-request and post-request scripts — full JS environment per request
Built-in JSON Schema generator — one click to generate a schema from any response
JSON path helper — autocomplete JSONPath expressions inside test editors
Variable autocomplete — every {{...}} input suggests available variables

Pre-request script editor in Postmate Client

Postmate Client vs Postman vs Thunder Client

Feature	Postmate Client	Postman	Thunder Client
Works offline	✅ Always	⚠️ Limited	⚠️ Limited
Works without login	✅ Always	❌ Required to use	⚠️ For paid features
No cloud sync	✅ Local-only	❌ Cloud default	✅ Local
Zero telemetry & tracking	✅ None	❌ Cloud account required	⚠️ Opt-out (On by default)
WebSocket / WSS support	✅ Free	⚠️ Yes (login required)	💰 Paid tier only
Pre/post-request scripts	✅ Built-in	✅ Yes	💰 Paid tier only
`pm` library	✅ Built-in	✅ Native	❌ Not supported
Side-by-side response compare	✅ Built-in	❌ Manual	❌ Not available
Bulk response comparison (CSV-driven)	✅ Built-in	❌ Scripting required	❌ Not available
Data tables linked to environments	✅ Built-in	❌ Not available	❌ Not available
Per-request data tag filtering	✅ Built-in	❌ Not available	❌ Not available
CLI for CI/CD	✅ Free, built-in	⚠️ Separate tool (Newman)	💰 Paid tier
Free features	✅ Everything	⚠️ Core features free	💰 Most features paid

Quick start

Install Postmate Client from the VS Code Marketplace.
Click the Postmate Client icon in the VS Code Activity Bar.
Click New Request, paste a URL, hit Send — your first API call without leaving the editor.

For WebSocket testing, click the dropdown next to New Request and choose WebSocket. Paste wss://echo.websocket.org, hit Connect, and send a JSON message to see it stream back in real time.

Read the Getting Started guide →

Resources

Full documentation →
Migrate from Postman →
WebSocket testing guide →
Compare API responses guide →
CLI reference →
Video tutorials on YouTube →
Discussion forum →
Report an issue / request a feature →

Feedback

Postmate Client is built by a developer who got tired of sending API tokens to someone else's cloud. If something doesn't work the way you'd expect, or you want a feature, open an issue on GitHub or post in the discussion forum. Every suggestion gets read.

License & dependencies

Postmate Client is licensed under a proprietary license. You are free to use it, but you may not redistribute, modify, or sell it without explicit permission.

Third-party libraries used: chai, mocha, node-fetch, jsonpath-plus, monaco-editor, uuid, esbuild, rimraf, typescript, vscode-test, and @types/* packages — each used under their respective MIT or Apache 2.0 licenses. Refer to each library for full license details.

Postmate Client

PostMate-lab