Repository avatar
AI Tools
v0.1.0
active

wizget

app.wizget/wizget

Lets your AI build and arrange live desktop widgets in the Wizget app for Windows and macOS.

Documentation

Wizget MCP server

Let your AI build widgets for your desktop and phone.

Wizget is a widget app for Windows, macOS and Android. It runs an MCP server on your computer, so any AI app that supports MCP can create, change and arrange widgets on your desktop. Ask for "my Stripe MRR with a ring to my $5k goal" or "a countdown to each of my exams", and the widget appears a few seconds later and keeps itself up to date.

The server is part of the Wizget app. It runs locally on 127.0.0.1 while Wizget is open, and nothing leaves your computer except the requests your widgets make to the services you connect. Wizget is paid software (one lifetime licence); this repository holds the setup guide and the skill file, not the app's source.

Setup

As a Claude Code plugin: run

/plugin install wizget --marketplace aqeelshamz/wizget-mcp

and paste your server address when it asks (step 2 below shows where to find it). The plugin adds the MCP server and the widget skill together.

By hand:

  1. Install Wizget from wizget.app and enter your licence key.
  2. In Wizget, open Custom → Connect your AI. It shows your server's address, which looks like http://127.0.0.1:7461/mcp/<your-token>. The token is unique to your install.
  3. Add it to your AI app as an HTTP (streamable HTTP) MCP server.

Claude Code: click Connect Claude in Wizget, or run:

claude mcp add --transport http --scope user wizget http://127.0.0.1:7461/mcp/<your-token>

Other apps that take an MCP config file:

{
  "mcpServers": {
    "wizget": {
      "type": "http",
      "url": "http://127.0.0.1:7461/mcp/<your-token>"
    }
  }
}

Then ask your AI: "What Wizget widgets would be useful for me?" It suggests widgets based on what it already knows about you, and builds the ones you pick.

Tools

ToolWhat it does
suggest_widgetsSuggests widgets for this user, with what's already on their desktop and in the gallery
create_widgetValidates a widget spec, saves it and puts it on the desktop
update_widgetReplaces a custom widget's spec; every copy reloads
screenshot_widgetA picture of how a widget looks now, so the AI can check its own work
validate_specChecks a spec without placing it
list_widgetsEvery widget on the desktop, with position and size
move_widget, resize_widget, pin_widget, arrange_widgetsLayout
remove_widget, refresh_widget, delete_specHousekeeping
list_gallery, get_spec, list_customRead the 111 built-in widgets to copy and change them

Resources: wizget://guide (the authoring guide) and wizget://schema (the JSON schema). Prompt: suggest_widgets.

No MCP? Use the skill

SKILL.md teaches any AI to write Wizget widgets. Give it to any chat AI, ask for a widget, and paste its reply into Custom → New from AI output in Wizget. On Android, paste it into the Wizget app. Agents that load skills (Claude Code and others) can use the file as is.

What widgets can show

  • Numbers from your accounts (Stripe, Shopify, GitHub, YouTube and any API with a key). Keys are pasted into Wizget, stored in your system's credential store, and only sent to the service they belong to.
  • Your day: calendar (iCal link), countdowns, world clocks, weather.
  • Things you tap: to-dos, timers, Pomodoro, notes, media controls.
  • Your computer: battery, CPU, memory, network, what's playing, how much of your AI plan is left.

Widgets can't run their own code or reach your local network, and Wizget checks every spec before it goes on screen.

Links

No installation packages available.