# WidgetDash

> WidgetDash is a freemium MCP server for productivity. Push numbers and status to iPhone Home Screen, Lock Screen widgets and Live Activities. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $4.9 a month
- **Platforms:** iOS, API, CLI
- **Website:** https://widgetdash.app
- **Repository:** https://github.com/purian/widgetdash-mcp
- **MCP Registry name:** io.github.purian/widgetdash-mcp
- **Categories:** productivity, analytics and data
- **Listing updated:** 2026-11-14

## About

Five tools write and read the sources behind a WidgetDash widget. `push_number` sets one metric, such as MRR, and creates the source if it does not exist; `push_metrics` replaces a source's whole metric list; `list_sources`, `get_widget_data` and `delete_source` read and remove them. Metrics can be numbers, text, status badges or progress bars (0 to 100), with colour options.

The agent needs a write key from the WidgetDash app, and an optional read key; without it the read tools use the write key. Example prompts in the README include sending Stripe MRR, GitHub stars, a server's CPU and uptime, or a CI pass or fail to the widget.

The iPhone app needs iOS 17.6 or later. The free plan allows 5 sources and all widget sizes, while Pro at $4.90 a month or $29.90 a year adds unlimited sources, Live Activities on the Lock Screen and Dynamic Island, and countdowns.

## Features

- **Push a single metric:** Set one labelled value without touching the others.
- **Replace a source:** Create or overwrite a source with a full metric list.
- **Readable widget state:** See current sources, metrics and update times.
- **Metric types:** Number, text, status badge and progress bar.
- **Source cleanup:** Delete a source and end its Live Activity.
- **Write and read keys:** Separate keys, with the write key as fallback.

## Good for

- Show Stripe revenue on a Lock Screen widget
- Report CI pass or fail to your phone
- Display server CPU and uptime
- Ask what your widget currently shows

## Install

### Claude Code (Terminal)

```sh
claude mcp add widgetdash-mcp --env WIDGETDASH_WRITE_KEY='<WIDGETDASH_WRITE_KEY>' --env WIDGETDASH_READ_KEY='<WIDGETDASH_READ_KEY>' -- npx -y widgetdash-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "widgetdash-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "widgetdash-mcp"
      ],
      "env": {
        "WIDGETDASH_WRITE_KEY": "<WIDGETDASH_WRITE_KEY>",
        "WIDGETDASH_READ_KEY": "<WIDGETDASH_READ_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "widgetdash-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "widgetdash-mcp"
      ],
      "env": {
        "WIDGETDASH_WRITE_KEY": "<WIDGETDASH_WRITE_KEY>",
        "WIDGETDASH_READ_KEY": "<WIDGETDASH_READ_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "widgetdash-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "widgetdash-mcp"
      ],
      "env": {
        "WIDGETDASH_WRITE_KEY": "<WIDGETDASH_WRITE_KEY>",
        "WIDGETDASH_READ_KEY": "<WIDGETDASH_READ_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "widgetdash-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "widgetdash-mcp"
      ],
      "env": {
        "WIDGETDASH_WRITE_KEY": "<WIDGETDASH_WRITE_KEY>",
        "WIDGETDASH_READ_KEY": "<WIDGETDASH_READ_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "widgetdash-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "widgetdash-mcp"
      ],
      "env": {
        "WIDGETDASH_WRITE_KEY": "<WIDGETDASH_WRITE_KEY>",
        "WIDGETDASH_READ_KEY": "<WIDGETDASH_READ_KEY>"
      }
    }
  }
}
```

## Tools

- `push_number`: Set one value on a source.
- `push_metrics`: Create or replace a source's metrics.
- `list_sources`: List sources and plan allowance.
- `get_widget_data`: Show current widget data.
- `delete_source`: Permanently delete a source.

## FAQ

### What do I need?

The WidgetDash iPhone app on iOS 17.6 or later and a write key.

### Is it free?

Free for 5 sources; Pro is $4.90 a month or $29.90 a year.

### Does it need an API URL?

It defaults to api.widgetdash.app and can be overridden.

### Can I install without code?

The app also offers ready-made sources with no code.

### Is WidgetDash free?

WidgetDash has a free plan, with paid plans for more usage or features. Paid plans start at $4.9 a month.

### How do I add WidgetDash to Claude Code?

Run this command in your terminal: claude mcp add widgetdash-mcp --env WIDGETDASH_WRITE_KEY='<WIDGETDASH_WRITE_KEY>' --env WIDGETDASH_READ_KEY='<WIDGETDASH_READ_KEY>' -- npx -y widgetdash-mcp

### What are the best alternatives to WidgetDash?

The closest alternatives to WidgetDash are Ha MCP, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Concord MCP and Tapetide - Indian Stock Market MCP.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.

---
Source: https://ai-powered.com/mcp/widgetdash
