nparrot

What it does

nparrot is a CLI utility and MCP server that enables asynchronous communication between humans and AI agents using the Nostr protocol (NIP-17). It allows you to send and receive direct messages from your phone (via any Nostr client) to an AI agent running on your computer, effectively turning Nostr into a remote control for your local LLM workflows.

Tools

• send: Sends a private NIP-17 direct message to a specified user.
• wait: Listens for the next incoming NIP-17 direct message and prints it to stdout.
• listen: Continuously monitors for new NIP-17 messages.
• onmessage: Triggers a specific shell command whenever a new Nostr DM is received.

Installation

Build from source using Cargo:

cargo build --release

To use as an MCP server, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "nparrot": {
      "command": "nparrot",
      "args": ["mcp"],
      "env": {
        "TARGET_PUBKEY": "your_pubkey",
        "NSEC": "your_nsec",
        "RELAY_URL": "wss://relay.damus.io"
      }
    }
  }
}

Supported hosts

• goose
• claude