npubmail

Install

Works with Claude Desktop. Read the repository before you give any tool access to your data.

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

5 read · 6 write · 1 delete · 4 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Downloaded binary

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• buy_storage

  Keep mail longer than 7 days. Answers with a Lightning invoice first; after it is paid, call again with payment_id.

• create_alias

  Create a disposable address that delivers into your mailbox and expires. Use one per signup; set allow_from to the service's domain so nothing else can reach it. Returns a cursor for wait_for_code.

• delete_email

  Delete an email from your mailbox.

• invoice_status

  Check whether a payment request (payment_id) has been paid.

• list_emails

  List received emails, newest first, with extracted codes and sender verification.

• outbox

  Sent emails still waiting for a retry (recipient server said 'try later'), plus your bounce count. Final failures arrive in your inbox as 'Undeliverable: ...'.

• pay_invoice

  Built-in wallet (optional): pay a Lightning invoice, within the spending limits. Paying is spending money: only pay what your principal allows. When set up, send_email pays npubmail's own invoices with it automatically (within limits).

• read_email

  Read one email: text body, links (verify/confirm links flagged as action), codes, SPF/DKIM result and safety warnings.

• send_email

  Send a plain-text email from your primary address. Recipients who never wrote to you cost sats: the first call answers PAYMENT REQUIRED with a Lightning invoice; after it is paid, call again with the same arguments plus payment_id. Per recipient: ok=true delivered; queued=true the receiving server asked to retry later and npubmail retries automatically for ~2 days (do not resend); ok=false without queued is a permanent failure. Daily recipient quota applies; too many bounces suspend sending. Only send what your principal asked for.

• set_lightning_address

  Optional. Make your mailbox addresses (name@domain, npub@domain) also work as Lightning addresses that forward to a Lightning address you already have (any wallet). npubmail only relays the lookup; payments go straight to your wallet. Empty address turns it off.

• storage_plan

  How long your mail is kept and the prices of longer storage tiers.

• wait_for_code

  Block until an email containing a one-time code arrives and return the code. Use the cursor from create_alias as 'after' so a code that arrives quickly is not missed.

• wait_for_email

  Block until a matching email arrives (default 120 s) and return it. Filters: from, to, subject.

• wallet_balance

  Built-in wallet (optional): collect incoming payments and show the balance.

• wallet_setup

  Optional convenience: only if you have NO Lightning wallet. Sets up a small built-in ecash wallet on the same key: your Lightning address becomes <npub>@npub.cash (payments locked to your key at the Minibits Cashu mint). Spending is capped (default 100 sats per payment, 1000 per day). The mint is custodial and in beta: small amounts only. Skip this if you already have a wallet.

Signals

Stars

0

Forks

0

Open issues

0

Last commit

Oct 8, 2026 (20 days ago)

Last release

Oct 8, 2026 (20 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

com.npubmail/npubmail

Version

0.2.1

Auth

No auth

Packages

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

License

MIT

Repository

github.com/obvioussummer46/npubmail

Website

npubmail.com

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql