English Français العربية

io.github.michaelyousrie/mailpal

Official registry Other

List, inspect, and run saved HTTP requests from MailPal collections; write tools on Pro

Source code Website Documentation

What can you do with io.github.michaelyousrie/mailpal?

  • Full request builder with a Postman-style editor: auto-growing key/value rows, header autocomplete, color-coded JSON editing with format and validation
  • Auto headers surfaced, so you see and control everything sent on the wire
  • Syntax-highlighted responses (JSON and XML), HTML raw/preview toggle, resizable request/response split
  • Per-collection variables with {{VAR}} placeholders; secret values live in your OS keychain, never in files
  • Unlimited local history with one-click re-send
  • Import Postman v2.1, Thunder Client, OpenAPI 3.x, and curl; export Postman and curl
  • Assertions per request with pass/fail on every send
  • A bundled MCP server, registered with VS Code agent mode automatically, so AI agents can list, run, and (with Pro) create requests

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mailpal-mcp
Claude Code 
claude mcp add mailpal -e 'MAILPAL_WORKSPACE=<MAILPAL_WORKSPACE>' -e 'MAILPAL_HISTORY_DIR=<MAILPAL_HISTORY_DIR>' -- npx -y mailpal-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mailpal": {
            "command": "npx",
            "args": [
                "-y",
                "mailpal-mcp@0.1.1"
            ],
            "env": {
                "MAILPAL_WORKSPACE": "<MAILPAL_WORKSPACE>",
                "MAILPAL_HISTORY_DIR": "<MAILPAL_HISTORY_DIR>"
            }
        }
    }
}

Environment variables

  • MAILPAL_WORKSPACE Folder containing the .mailpal collections directory
  • MAILPAL_HISTORY_DIR Where run history is written (default ~/.mailpal/history)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MailPal
  2. Why MailPal exists
  3. Highlights
  4. For AI agents (MCP)
  5. Support

MailPal

The honest API client for VS Code.

Collections, variables, unlimited history, an MCP server for AI agents, and a free tier that stays free.

Install from the VS Code Marketplace

Why MailPal exists

The most popular REST client for VS Code has 7.4 million installs and a 2.5 star rating, because its free tier slowly moved everything, including your own request history, behind a paywall.

MailPal makes the opposite promise, and treats it like a contract:

  • The free tier is fully usable for a single user, forever.
  • Unlimited requests, unlimited collections, unlimited local history.
  • Pro adds new value only. It never gates access to your own data.
  • If a license lapses, Pro features stop. Everything else keeps working.

Highlights

  • Full request builder with a Postman-style editor: auto-growing key/value rows, header autocomplete, color-coded JSON editing with format and validation
  • Auto headers surfaced, so you see and control everything sent on the wire
  • Syntax-highlighted responses (JSON and XML), HTML raw/preview toggle, resizable request/response split
  • Per-collection variables with {{VAR}} placeholders; secret values live in your OS keychain, never in files
  • Unlimited local history with one-click re-send
  • Import Postman v2.1, Thunder Client, OpenAPI 3.x, and curl; export Postman and curl
  • Assertions per request with pass/fail on every send
  • A bundled MCP server, registered with VS Code agent mode automatically, so AI agents can list, run, and (with Pro) create requests

For AI agents (MCP)

The MCP server also ships standalone on npm as mailpal-mcp:

claude mcp add mailpal -- npx -y mailpal-mcp

Works with any MCP client (Cursor, Claude Desktop, and friends) via npx -y mailpal-mcp.

Support

Questions, bugs, and feature requests: open an issue.

This repository hosts the project's public home, issues, and media. The extension itself ships through the VS Code Marketplace.

Frequently asked questions

What is io.github.michaelyousrie/mailpal?

List, inspect, and run saved HTTP requests from MailPal collections; write tools on Pro

How do I install io.github.michaelyousrie/mailpal?

It runs on your machine. In Claude Code: claude mcp add mailpal -e 'MAILPAL_WORKSPACE=<MAILPAL_WORKSPACE>' -e 'MAILPAL_HISTORY_DIR=<MAILPAL_HISTORY_DIR>' -- npx -y mailpal-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.michaelyousrie/mailpal need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.michaelyousrie/mailpal open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.michaelyousrie/mailpal?

It is published by michaelyousrie. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.