# 📬 Magic Inbox – Peer-to-Peer Teleportation & Forum Messaging Module for n8n

Tutorials English 🇬🇧
1

Magic Inbox is a custom extension for n8n that allows you to teleport workflows, messages, or files instantly between n8n instances—using webhooks as pure peer-to-peer, with no centralized server.
Not just for private transfer, Magic Inbox also brings “forum-style” group channels, making teamwork and community sharing frictionless.

:triangular_flag: What is Magic Inbox?

Magic Inbox lets you:

  • Instantly teleport (import/export) n8n workflows between friends, servers, or teams
  • Chat, share files or create collective flows across open or private channels (“forums”)
  • Control exactly what you accept and from whom, thanks to sender allowlisting and message type filtering
  • Use various messaging modes: P2P, team forum, or custom group endpoints

:sparkles: Features Overview

  1. Teleportation:

    • Send and receive workflows (and their content) to/from any n8n, as easily as sending a message—true “teleportation”, with optional auto-import

  2. Forum Channels:

    • Set up community or project channels (e.g. /chat/general, /chat/help, /chat/inspiration) where many users can exchange messages and teleport workflows
    • Each forum node listens on its own path, keeping group content organized and separated

  3. Custom Group Inboxes:

    • Need a private team space? Just set a custom path (e.g. /chat/my-team-lab) for your group

  4. Security & Filters:

    • Allowlist (whitelist) senders to restrict who can post/teleport to your inbox
    • Filter accepted types (chat, workflow, file) per node
    • All exchanges encrypted via HTTPS

  5. Auto-import:

    • Instantly import a workflow into your n8n on reception (if enabled), using your own API key and instance URL
    • Never shares your API key or credentials! Import only runs locally and if you enable it

  6. Open & Flexible:

    • 100% webhook-based: no cloud, no middleware, works on-prem, behind VPN, on any server or PC
    • Docs, UI hints, and parameters fully described for every user

:label: Main Parameters

  • inboxMode: Choose P2P, forum or custom group
  • forumRoom: The forum/channel path (if forum mode)
  • customRoomPath: Custom path (for custom modes)
  • acceptedTypes: Accept only chat, workflows, or files
  • allowlist: Enter allowed sender IDs (emails, aliases)
  • autoImport: Enable if you want workflows to import on-the-fly (needs n8n URL + API key)
  • addressBook: Personal directory of favorite endpoints or collaborators

:cyclone: Usage & Scenarios

1. Private P2P Teleportation

Set up a Magic Inbox node with mode: p2p.
Share your webhook URL (e.g. /magic-inbox).
Any contact with MagicInboxSend can teleport you a workflow/message/file directly.

2. Forum Channel Collaboration

Create a Magic Inbox node with mode: forum.
Pick a room (e.g. /chat/general).
Anyone with the endpoint can post/teleport content.
Works like a Slack/Discord channel, but P2P and decentralized!

3. Custom Team/Project

Set mode to custom, define a path (e.g. /chat/growth-hackers).
Only share with your team—get a private group chat with built-in workflow teleportation.

4. Receive and “Auto-Teleport” Workflows

Activate auto-import, fill your instance URL and API key.
Every workflow teleported (and accepted) is instantly cloned/imported in your n8n — real magic!

:outbox_tray: Sending (Teleporting)

Use MagicInboxSend node:

  • Destination: any MagicInbox webhook (user, forum, group)
  • Set your public ID, message, type of content, and attach workflows or files as needed
  • The “teleportation” happens as soon as the peer node receives it!

:books: Installation

Install via npm:

npm install n8n-nodes-magic-inbox

Or copy the node directory to: ~/.n8n/custom/nodes/ and restart n8n.

:shield: Security Model

  • No server in the middle: all peer-to-peer, via HTTPS
  • Allowlist: block all senders except those you trust
  • Auto-import only runs if enabled and with your local credentials
  • All forum/group channels are just paths : you decide who shares/teleports there

:vertical_traffic_light: Good Practice Tips

  • Use a forum node per channel group to keep flows sorted
  • Protect your inbox URLs (don’t broadcast public unless you intend open forum)
  • Have descriptive sender IDs for tracking
  • Combine with team chat tools (Telegram, Slack) as you wish—Magic Inbox is compatible

:eye: Example: Use-Cases

  • Instantly teleport a critical workflow from staging to production n8n via P2P
  • Set up a “General” or “Jobs” forum and invite many users to exchange workflows without admin
  • Use a custom team inbox for a temporary project, then delete it for privacy

:raising_hands: Credits

Made by Charles Lepoittevin, 2025 (Montpellier, Occitanie)
Contact: [email protected]
Inspired by blockchain, P2P, and the dream of instant, human-friendly automation sharing.

Magic Inbox is minimal.
It teleports your workflows and builds real community.
It’s yours—and it’s magic.

2

Super idée bravo ! :smiley: