# npubmail

> npubmail is a freemium MCP server for communication. Give an agent its own email inbox, keyed to a Nostr key, with no signup. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://npubmail.com
- **Repository:** https://github.com/obvioussummer46/npubmail
- **MCP Registry name:** com.npubmail/npubmail
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

npubmail makes an agent's keypair the account: running npubmail init creates a key and a mailbox such as myagent@npubmail.com in about a second, with no captcha, password or API key. The MCP server runs locally over stdio, so the key stays on the agent's machine and every request is signed there (NIP-98).

It is built around agent chores like signing up for services: disposable aliases can be created per signup with a time limit, and a command waits and prints the verification code when mail arrives. Stored messages are sealed to the owner's Nostr key so the server cannot read them. Receiving and replying to people who wrote first are free; mailing a new recipient costs 10 sats per recipient over Lightning or Cashu ecash, and longer storage is paid per 30 days.

The clients, library and MCP server are MIT licensed, while the mail backend is a hosted service. The README warns the key file is the only credential and there is no reset.

## Features

- **Key is the account:** A Nostr keypair creates the mailbox with no signup or password.
- **Disposable aliases:** Create sender-locked or time-limited addresses for sign-ups.
- **Wait for codes:** A command blocks until mail arrives and prints the verification code.
- **Sealed storage:** Messages are encrypted to the owner's key, so the server cannot read them.
- **Pay per action:** Mailing new recipients is paid in sats over Lightning or Cashu.
- **Local MCP server:** Runs over stdio so the key never leaves the machine.

## Good for

- Let an agent receive a verification code during sign-up
- Give each service a disposable address
- Reply to people who emailed the agent
- Send a message to a new recipient with a Lightning payment

## Install

### Claude Code (Terminal)

```sh
claude mcp add npubmail -- npx -y https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "npubmail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "npubmail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "npubmail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "npubmail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "npubmail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
```

## FAQ

### Is signup needed?

No. The agent's Nostr key is the account.

### What is free?

Mailbox and aliases, receiving, 7-day storage, replies to people who wrote to you and mail to other npubmail mailboxes, up to 50 recipients a day.

### What costs money?

Mailing someone who has not written to you costs 10 sats per recipient, and longer storage is priced per 30 days.

### What if I lose the key?

The README says there is no reset, so back it up.

### Is the code open source?

The clients, library, MCP server and skill are MIT; the hosted mail backend is not.

### Is npubmail free?

npubmail has a free plan, with paid plans for more usage or features.

### How do I add npubmail to Claude Code?

Run this command in your terminal: claude mcp add npubmail -- npx -y https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb

### What are the best alternatives to npubmail?

The closest alternatives to npubmail are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/npubmail
