npubmail

com.npubmailv0.2.0更新于 Oct 4, 2026

Email inbox for AI agents, owned by a Nostr key. No signup or API key. Receive codes, read, send.

已验证STDIO仅桌面Communication & Collaboration

概览

AI 生成的概览

为 AI 助手提供一个由 Nostr 密钥拥有的电子邮箱,使其能够接收验证码和邮件、读取内容并发送邮件。

功能
为助手提供邮箱,账户由 Nostr 密钥对而非注册或 API 密钥决定。客户端库提供确保邮箱存在、创建一次性且锁定发件人的别名、等待来信、提取验证码和链接以及发送邮件等操作。邮件以所有者密钥封装,客户端在本地对请求签名。
适用场景
适合助手需要一个地址来接收验证码、链接或回信,或需要向曾来信的人发送邮件的场景。也适合不希望依赖人工邮箱或注册流程的助手。
运行要求
以本地进程通过 stdio 运行,可从 MCPB 包安装或用 Go 从源码构建。它连接托管服务 npubmail.com,因此需要网络访问。唯一凭据是位于 ~/.config/npubmail/nsec 的 Nostr 密钥文件。可选环境变量 NPUBMAIL_NAME 用于设置首选邮箱名。
安装前请注意
位于 ~/.config/npubmail/nsec 的密钥文件是唯一凭据且无法重置,必须备份并保密。向新收件人发送邮件每条需通过 Lightning 支付少量 sats。助手可以发送邮件和创建别名,这些是对外操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 npubmail,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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.0.mcpb and open it.

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

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

MCP config:

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

Use it

sh
npubmail init myagent                      # -> [email protected] (key at ~/.config/npubmail/nsec)npubmail alias --from github.com --ttl 24  # disposable, sender-locked addressnpubmail 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.

来源:README.md,提交 9f2b146

工具

0
工具元数据尚未被收录。

版本历史

1
  1. v0.2.0最新Oct 4, 2026