esc

AI apps

Claude, Cursor, Codex and other MCP apps can use your add-ons, like asking Notes for a note or adding one. It's off until you turn it on, and you decide which apps and which add-ons.

Turning it on

In Settings → AI apps, turn on Let AI apps use add-ons. Then turn on each add-on whose tools an app may use; the page lists what each one offers.

Until an add-on's tools are on, an app sees a single tool, ledge_setup, that says which add-ons offer tools and where to turn them on, so it can tell you instead of guessing. Turn one on and the app sees its tools straight away; there's no need to restart Ledge.

Ledge's own tools

Ledge offers some tools of its own, in groups with a switch each under Ledge on the same page, all off to start:

  • Music: what's playing, and play, pause, next or previous.
  • System and weather: battery, CPU, memory and free disk space, and the weather where you chose, which gives away that place.
  • Messages in the notch: a short message, signed with the app's name, at most one every 10 seconds.

None of them reads your clipboard history or what's on the shelf.

Connecting an app

Apps reach Ledge through ledge-mcp, inside Ledge. The page shows its path and a button to copy it. In Claude Code or Codex:

claude mcp add --scope user ledge -- "/Applications/Ledge.app/Contents/MacOS/ledge-mcp"
codex mcp add ledge -- "/Applications/Ledge.app/Contents/MacOS/ledge-mcp"

In Claude, Cursor and other apps, add an MCP server named ledge with that path as its command.

What Ledge asks

  • The first time an app connects, Ledge asks whether to let it in. It names the app from the programs that started it and who signed them, not from what the app says about itself, like “claude in Terminal”. Allowing one app never lets in the same program started from somewhere else.
  • A tool that can't be undone asks every time, in the notch, with what it would do. Closing the notch or no answer in 30 seconds is no. Over a full-screen app, where the notch is hidden, it asks in a window instead.
  • Everything else runs when the app asks, for the add-ons you turned on.

Apps you've let in lists each app with a Remove button, and Recent shows every call: which app used which add-on's tool, and whether it worked.