Cloudflare Quick Tunnels

Understand the risks

Beeper Desktop API is designed to be used locally on your computer. Exposing it to the internet can expose chat history and might allow others to send messages on your behalf. Please only continue if you understand the risks.

Beeper is not responsible for any consequences arising from exposing Beeper Desktop API to the internet.

Also note that Beeper has no affiliation with Cloudflare and this guide is for educational purposes only.

Cloudflare’s Quick Tunnels spins up an HTTPS endpoint that forwards traffic straight to your local Beeper Desktop API. The tunnel lives only as long as the cloudflared process runs, making it ideal for testing and personal usage.

Before you begin, make sure Remote Access is enabled in Settings → Developers → Beeper Desktop API → Advanced settings so the server listens on all interfaces.

Cloudflare Quick Tunnels does not support Server Sent Events (SSE) (/v0/sse), so if you are using the MCP server you must use the Streamable HTTP transport (/v0/mcp).

Read more about Remote Access

Install cloudflared

macOS

Install via Homebrew:

macOS

brew install cloudflare/cloudflare/cloudflared

Windows

Use Windows Package Manager:

Windows

winget install Cloudflare.cloudflared

Linux

Download the latest release and install it manually:

Debian/Ubuntu

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb -o cloudflared.deb
sudo dpkg -i cloudflared.deb

Make sure to check Cloudflare’s Downloads page for the most up to date instructions.

Launch a quick tunnel

1. Start the tunnel

   Forward Beeper Desktop

   cloudflared tunnel --url http://localhost:23373

2. Copy the forwarding URL

   cloudflared prints a line similar to https://example.trycloudflare.com. Append /v0/mcp for the MCP server.

3. Authenticate from your remote tool

   Use the standard OAuth or token flow. Cloudflare preserves forwarded headers, so the Desktop API generates redirect URLs based on the public hostname automatically.

Keep the tunnel online

The URL is only valid while the cloudflared process runs. Use a session manager such as screen, tmux, or a background service if you need to keep it available. Press Ctrl + C to close the tunnel immediately.

Harden for stable deployments

Cloudflare Quick Tunnels has request limits and no authentication. For persistent deployments on Cloudflare, you can use Cloudflare Zero Trust:

Set up a named Cloudflare Tunnel

Zero Trust tunnels let you pin a hostname, enforce identity checks, and restrict IP ranges—all without changing your local Beeper Desktop configuration.