Luma Remote

Luma Remote · For Mac

Your LG TV.
Now on your Mac.

Lost the remote again? Pair once and control your LG TV from your Mac: navigate, switch inputs, launch apps and type, all over your home network.

Requires macOS 14 Sonoma or later · Apple silicon and Intel · LG webOS TVs

Free to download. Tested on an LG OLED C4; recent LG webOS TVs use the same protocol.

The Luma Remote window

The remote is always somewhere.
Your Mac is right here.

Between the couch cushions, under a blanket, in another room. Luma Remote puts every button one click away, and lets your keyboard do the typing.

Everything the remote does. Faster.

Built natively in SwiftUI for one job: driving an LG TV from your Mac, with no cloud in between.

✛

A real remote, not a web page.

Arrows, OK, Back, Home, volume, mute, playback and channels, laid out like the remote in your hand, plus a touchpad for the webOS pointer.

▦

Apps and HDMI in one click.

See every installed app with its real icon and every HDMI input by name. Jump straight to Netflix or your PS5 without scrolling a launcher.

⚭

Pair once.

Approve the prompt on the TV, or enter the PIN it shows. The app remembers the key and reconnects on its own.

1×
pairing, then automatic
⏻

Wakes it up, too.

Turn the TV off from your Mac and bring it back with Wake-on-LAN. Standby is detected, so the status is never stale.

~6 s
from standby to ready
⌨︎

Type on your TV.

TV search boxes are painful. Type on your Mac keyboard and send the text straight to the focused field.

◎

Finds your TV.

Discovers LG TVs on your network automatically, or add one by IP address. Switch between several TVs from the toolbar.

◐

Feels at home.

Follows your Mac's light or dark appearance and speaks your language: English, 简体中文, 繁體中文, 日本語, 한국어, Français, Deutsch and Español.

8
languages

Built-in MCP server

Let AI agents
run your TV.

Luma Remote speaks the Model Context Protocol. Claude, Cursor, Codex and other agents can check the TV, launch apps, switch inputs, change the volume and turn it on or off, using the same paired, local connection.

Turn on the TV, open YouTube and set the volume to 15.
tv_poweraction: "on"
tv_launch_appapp: "YouTube"
tv_volumeaction: "set", level: 15
Done. The TV is on, YouTube is open and the volume is 15.

Connect in one line.

Copy the config from Settings → MCP Service. Use HTTP for clients that take a URL, or stdio for the rest; the app starts itself when needed.

{
  "mcpServers": {
    "luma-remote": {
      "url": "http://127.0.0.1:8765/mcp"
    }
  }
}

15 tools.

Everything the app can do, available to your agent.

tv_statustv_list_devicestv_select_devicetv_list_appstv_launch_apptv_list_inputstv_switch_inputtv_press_buttontv_volumetv_mutetv_mediatv_channeltv_input_texttv_powertv_notify

The MCP server listens only on 127.0.0.1 and rejects requests from web pages. Turn it off any time in Settings.

Up and running in a minute.

Install

Download the app, drag it to Applications, and allow Local Network access when macOS asks.

Pair

Pick your TV from the list and approve the prompt on screen, or enter the PIN it shows.

Control

Use the remote, launch apps and switch inputs, or hand the job to your AI agent.

15MCP tools for AI agents
~6 sto wake from standby
0cloud servers involved
1.9 MBdownload size

Your TV stays on your network.

Luma Remote talks to your TV directly. No account. No cloud. No analytics.

Local only

Uses LG's local webOS protocol on your home network. Nothing passes through an outside server.

Pinned connection

The TV's certificate is pinned at first pairing, so another device can't pose as your TV.

MCP stays on this Mac

The agent server binds to 127.0.0.1 and rejects requests coming from web pages.

No tracking

No accounts, telemetry or ads. Pairing keys are stored only on your Mac.

What the app does, and what it does not do.

  • It controls LG webOS TVs on the same local network, after you approve pairing on the TV.
  • It does not work over the internet and does not control TVs from other brands.
  • The MCP server has no password: while it is on, any program on your Mac can use it. Turn it off in Settings if you don't need it.
  • Luma Remote is an independent app, not affiliated with or endorsed by LG Electronics.

Questions & answers

Which TVs are supported?

LG TVs running webOS with the second-screen (SSAP) protocol. It is tested on an LG OLED C4; most LG webOS TVs from recent years work the same way.

How do I pair my TV?

Make sure the Mac and the TV are on the same network, pick the TV in Devices and click Connect. Approve the prompt on the TV, or choose PIN pairing and type the code shown on screen. You only do this once.

Why does macOS ask for Local Network access?

The app needs it to find and talk to the TV on your home network; without it, macOS blocks the connection. You can change it later in System Settings → Privacy & Security → Local Network.

Can it turn the TV on?

Yes, with Wake-on-LAN. On the TV, turn on “Turn on via Wi-Fi” (also called Mobile TV On) in the connection settings. The TV must have been connected once, so the app knows its MAC address.

How do I connect an AI agent?

Open Settings → MCP Service and copy the HTTP or stdio config into your agent's MCP settings, for example in Cursor or Claude Desktop. Then ask things like “Open Netflix on the TV”.

Does any data leave my network?

No. The app talks to your TV directly over your LAN. There is no account, no analytics and no server. Even app icons are loaded from the TV itself.

What are the system requirements?

macOS 14 Sonoma or later on Apple silicon or Intel. The interface is available in English, Simplified and Traditional Chinese, Japanese, Korean, French, German and Spanish.

Luma Remote

Put the remote
down for good.

Requires macOS 14 Sonoma or later · Apple silicon and Intel · LG webOS TVs