How do I install Npubmail?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Npubmail need an API key?

The publisher lists these environment variables: NPUBMAIL_NAME.

What transport does Npubmail use?

Npubmail runs locally over stdio.

When was Npubmail last checked?

Last checked 2026-11-08. Email inbox for AI agents, owned by a Nostr key. No signup or API key. Receive codes, read, send.

Npubmail MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

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

Credentials from the publisher

NPUBMAIL_NAME — Preferred mailbox name (becomes <name>@npubmail.com if free). Optional.

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1NPUBMAIL_NAME=<value> claude mcp add com.npubmail-npubmail -- mcpb https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.npubmail-npubmail": {4      "command": "mcpb",5      "args": [6        "https://github.com/obvioussummer46/npubmail/releases/download/v0.2.1/npubmail-mcp-0.2.1.mcpb"7      ],8      "env": {9        "NPUBMAIL_NAME": "<value>"10      }11    }12  }13}

claude_desktop_config.json

Local · mcpbPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.1
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

npubmail clients

Email for AI agents, owned by a Nostr key. No signup, no password, no API key: the agent's keypair is the account.

This repository holds the open clients for the hosted service at npubmail.com:

cmd/npubmail: command-line client

cmd/npubmail-mcp: MCP server (Claude Code, Hermes, OpenClaw, any MCP client)

client/: Go library (EnsureMailbox, CreateAlias, WaitFor, Send, ...)

skills/npubmail/SKILL.md: agent skill

docs/: HTTP API, the sealed-mail format (SEAL.md) with test vectors, and Python/JS examples

Install

One click (Claude Desktop and other MCPB clients): download npubmail-mcp-0.2.1.mcpb and open it.

Listed in the official MCP Registry as com.npubmail/npubmail.

curl -fsSL https://npubmail.com/install | sh # prebuilt, checksummed binaries # or from source: go install github.com/obvioussummer46/npubmail/cmd/npubmail-mcp@latest go install github.com/obvioussummer46/npubmail/cmd/npubmail@latest

MCP config:

mcp_servers: npubmail: command: npubmail-mcp # talks to https://npubmail.com timeout: 660 # wait_for_* can block up to 600 s

Use it

npubmail init myagent # -> [email protected] (key at ~/.config/npubmail/nsec) npubmail alias --from github.com --ttl 24 # disposable, sender-locked address npubmail code --timeout 120 # block until mail arrives, print the OTP

What the service does

Receive: free. Disposable aliases per signup, codes and links extracted.

Encrypted at rest: each message is sealed to the owner's Nostr key (see docs/SEAL.md); the server cannot read stored mail.

Send: replies to people who wrote to you are free, and so is mail to other npubmail mailboxes. Mailing a new recipient costs a few sats over Lightning, per message, with no account balance.

Inbound TLS (STARTTLS), DKIM/SPF/DMARC on outbound.

Your key is your account

~/.config/npubmail/nsec is the only credential. Back it up; there is no reset. The clients sign every request locally (NIP-98) and never send the key anywhere.

Licence

MIT (LICENSE): clients, library, protocol packages, skill and examples. The server is not in this repository.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Npubmail?

Does Npubmail need an API key?

What transport does Npubmail use?

When was Npubmail last checked?

Documentation

npubmail clients

Install

Use it

What the service does

Your key is your account

Licence