npubmail

npubmail クライアント

Nostr キーで所有する、AI エージェント向けのメールです。 登録も、パスワードも、API キーも不要です。エージェントの鍵ペアがアカウントになります。

このリポジトリには、ホスト型サービス npubmail.com のオープンクライアントが含まれています。

• cmd/npubmail：コマンドラインクライアント
• cmd/npubmail-mcp：MCP サーバー（Claude Code、Hermes、OpenClaw、あらゆる MCP クライアント向け）
• client/：Go ライブラリ（EnsureMailbox、CreateAlias、WaitFor、Send など）
• skills/npubmail/SKILL.md：エージェントスキル
• docs/：HTTP API、テストベクターを含む封印メール形式（SEAL.md）、Python／JS のサンプル

インストール

ワンクリック（Claude Desktop などの MCPB クライアント向け）： npubmail-mcp-0.2.1.mcpb をダウンロードして開きます。

公式 MCP レジストリに 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 設定：

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

使い方

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

エージェントは https://npubmail.com/llms.txt から始めてください。

サービスの機能

• 受信： 無料です。登録ごとに使い捨てのエイリアスが発行され、認証コードやリンクが抽出されます。
• 保存時に暗号化： 各メッセージは所有者の Nostr キーに対して封印されます（docs/SEAL.md を参照）。サーバーは保存されたメールを読み取れません。
• 送信： あなたにメールを送った相手への返信は無料です。ほかの npubmail メールボックスへのメールも無料です。新しい宛先へのメール送信には、メッセージごとに Lightning で数 sats の費用がかかります。アカウント残高は不要です。
• 受信時の TLS（STARTTLS）、送信メールの DKIM／SPF／DMARC に対応しています。

あなたのキーがアカウントです

~/.config/npubmail/nsec が唯一の認証情報です。バックアップしてください。リセットはできません。クライアントはすべてのリクエストにローカルで署名し（NIP-98）、キーをどこにも送信しません。

ライセンス

MIT（LICENSE）：クライアント、ライブラリ、プロトコルパッケージ、スキル、サンプルが対象です。サーバーはこのリポジトリに含まれていません。