Blog

Let your AI assistant update your iPhone widget

· 1 min read

If you already ask an AI assistant to look things up, it can also put the answer where you will see it. WidgetDash has an MCP server, widgetdash-mcp, that lets Claude, Cursor and other MCP clients push numbers to your iPhone widget. You ask in plain words, and the assistant makes the call.

Connect it

You need Node.js 18 or later and your write key from widgetdash.app/app. In Claude Code it is one command:

claude mcp add widgetdash -e WIDGETDASH_WRITE_KEY=your-write-key -- npx -y widgetdash-mcp

In Claude Desktop, add it to claude_desktop_config.json:

{
  "mcpServers": {
    "widgetdash": {
      "command": "npx",
      "args": ["-y", "widgetdash-mcp"],
      "env": { "WIDGETDASH_WRITE_KEY": "your-write-key" }
    }
  }
}

Other MCP clients take the same command and the same environment variable.

Then ask

  • "Put my Stripe MRR on my iPhone widget." The assistant reads the number with a Stripe tool, then sets it on the widget.
  • "Make a Server widget with CPU as a progress bar and a green Healthy badge."
  • "Every time you finish a build, set the CI status to Passing or Failing."
  • "What's on my widget right now?"

Behind each request is one of five tools: push_number sets one value and leaves the others alone, push_metrics builds a whole source, and get_widget_data, list_sources and delete_source read and tidy up.

Where it helps most

An assistant is good at the step before the push: finding the number. It can add up this week's orders, count open issues or read a value off a page, then put the result on your Home Screen in the same conversation. For a number that changes on a schedule, a script is still the better fit, because it runs without you: see how to know your cron job ran.

The server is open source on GitHub and published on npm as widgetdash-mcp.

Put your own numbers on your iPhone

WidgetDash shows any number you push on your Home Screen and Lock Screen widgets. Free for up to 5 sources.

Get it on the App Store Read the setup guide

More from the blog

Know your cron job ran, without opening a logNovember 8, 2026A real setup: subscription days that turn red on their ownNovember 6, 2026Know when to leave: a live bus and train card on your iPhoneNovember 7, 2026