n8n-nodes-magic-inbox/README.md

Magic Inbox P2P - Revolutionary workflow teleportation system for n8n

# 📬 Magic Inbox P2P for n8n — ✨ Instantly Teleport Workflows

**Magic Inbox** is the simplest, most powerful way to **TELEPORT your workflows, messages, or files** between any two n8n instances — instantly, securely, and with no central server.

All you need:  
- A Magic Inbox _receiver_ ("Inbox" node, webhook trigger)  
- A Magic Inbox _sender_ ("Send" node, transformer)  
- A trusted peer’s webhook URL — and the magic happens!

---

## ✨ Teleport Your Automation

- 🚀 **Click, Send, Teleport:** Send a workflow or any file to another n8n, anywhere in the world, with a single node.
- 🪄 **No cloud, no barriers:** Pure peer-to-peer transfer. Your workflow arrives instantly and privately on the recipient's machine, ready-to-use and auto-imported if you wish.
- 🔁 **Collaborate with your team:** Share, delegate, or migrate automations on demand, without manual copy-paste or API scripting.

---

## 🔹 Features

- 📤 **Teleport workflows, files, and secure messages** P2P between n8n servers
- 📬 **Receive and auto-import** (optional) any incoming workflow — no extra steps!
- ⚡️ **Works across docker, cloud, self-hosted — anywhere n8n runs**
- 🔐 **Whitelist** option: restrict trusted senders
- 🔄 **Simple vs Advanced:** auto-import for speed, raw mode for power users

---

## 🛠️ Installation

**npm:**
npm install n8n-nodes-magic-inbox

text

**Docker volume:**
cd /var/lib/docker/volumes/n8n_data/_data/nodes/
npm install n8n-nodes-magic-inbox
docker restart <n8n-container>

text

---

## 🚦 Usage: Teleport in 3 Steps

1. **Create a workflow on n8n-A with your favorite nodes**
2. **Add Magic Inbox Send.**  
   - Set "Destination Magic Inbox URL" to your teammate’s or other n8n’s Inbox node webhook.
   - Choose content type: *Workflow + Message* for teleportation.
3. **On n8n-B:**  
   - Add and enable a Magic Inbox node (receiver) in any workflow.
   - When you hit “Send” on n8n-A, your workflow is instantly delivered/teleported!

**Auto-import enabled?** The workflow appears, active, in the recipient’s n8n — like magic 🪄

---

## ⚙️ Main Parameters

- **Destination Magic Inbox URL:**  
  Where to teleport your automation (recipient's webhook).
- **Workflow JSON:**  
  Paste the full export from n8n’s workflow page (no manual API!).
- **Auto Import:**  
  If enabled, new workflows are instantly usable by the recipient.
- **Whitelist:**  
  Allow only trusted emails/IDs as senders.

---

## 📝 Example — Teleport a Workflow

On n8n-A:
- Export your workflow as JSON (from the workflow menu)
- Use Magic Inbox Send with destination URL from n8n-B’s Inbox node
- Attach the exported JSON and an optional message

On n8n-B:
- Magic Inbox node receives, parses, and (optionally) auto-imports the workflow into your library

No code, no copy-paste, **no cloud** — just teleport!

---

## 🐞 Bug Report / Contribute

- GitHub: [https://github.com/magic-dev/n8n-nodes-magic-inbox](https://github.com/magic-dev/n8n-nodes-magic-inbox)
- Email : contact@magic-dev.net

---

## 📜 License

MIT © Charles Magic Dev

---

**Magic Inbox — _THE easiest way to instantly teleport automations between any n8n instances._**