
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:
- Install Wizget from wizget.app and enter your licence key.
- 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. - 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
| Tool | What it does |
|---|---|
suggest_widgets | Suggests widgets for this user, with what's already on their desktop and in the gallery |
create_widget | Validates a widget spec, saves it and puts it on the desktop |
update_widget | Replaces a custom widget's spec; every copy reloads |
screenshot_widget | A picture of how a widget looks now, so the AI can check its own work |
validate_spec | Checks a spec without placing it |
list_widgets | Every widget on the desktop, with position and size |
move_widget, resize_widget, pin_widget, arrange_widgets | Layout |
remove_widget, refresh_widget, delete_spec | Housekeeping |
list_gallery, get_spec, list_custom | Read 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
- Website: wizget.app
- Widget reference: wizget.app/widgets/reference
- Support: hello@wizget.app
No installation packages available.