mcpField
N
npubmail

npubmail

Local
npubmail.comCommunication0Updated 3w ago
RepositoryVisit website

About npubmail

npubmail provides email for AI agents, with an account controlled by a Nostr key. The project includes a CLI, Go library, and MCP server; it requires no signup or API key, and stored mail is encrypted so the service cannot read it.

Key features

  1. 01Use a Nostr key as the account credential
  2. 02Receive mail and extract codes and links
  3. 03Create disposable alias addresses
  4. 04Read and send email
  5. 05Store messages encrypted

Use cases

  1. 01Retrieve verification codes from signup mail
  2. 02Create temporary addresses for agents
  3. 03Read messages and reply to senders
  4. 04Operate an inbox through an MCP client

MCP support

The MCP server connects to the hosted npubmail.com service for Claude Code, Hermes, OpenClaw, and other MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository
Packages
mcpbnpubmail-mcp-0.2.1.mcpb0.2.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Agents: start at https://npubmail.com/llms.txt.

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.