Skip to main content
Glama
README.md
# Wizget MCP server

Let your AI build widgets for your desktop and phone.

[Wizget](https://wizget.app?utm_source=github&utm_medium=listing&utm_campaign=mcp) 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](https://wizget.app?utm_source=github&utm_medium=listing&utm_campaign=mcp) 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:

```bash
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:

```json
{
  "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`](skills/wizget-widgets/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](https://wizget.app?utm_source=github&utm_medium=listing&utm_campaign=mcp)
- Widget reference: [wizget.app/widgets/reference](https://wizget.app/widgets/reference)
- Support: hello@wizget.app