Skip to content
MCP server

npubmail

Give an agent its own email inbox, keyed to a Nostr key, with no signup

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.2.1
Listing updated
2 days ago

About npubmail

npubmail is a freemium MCP server for communication. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "npubmail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "npubmail": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • NPUBMAIL_NAMEPreferred mailbox name (becomes <name>@npubmail.com if free). Optional.

What it does

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

Pricing

Freemium

Free mailbox and receiving; sending to new recipients costs 10 sats each over Lightning or Cashu

Prices change. Check npubmail.com before you buy.

npubmail 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 to npubmail

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity