Skip to content
MCP server

WidgetDash

Push numbers and status to iPhone Home Screen, Lock Screen widgets and Live Activities

Runs locallyStatus and history
Pricing
Freemium
Platforms
iOS, API, CLI
Runs
Locally
Version
0.2.0
Listing updated
2 days ago

About WidgetDash

WidgetDash is a freemium MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • WIDGETDASH_WRITE_KEYWidgetDash write key (from https://widgetdash.app/app). Required to push or delete widget data.Required
  • WIDGETDASH_READ_KEYOptional WidgetDash read key for read-only tools. Falls back to the write key.
  • WIDGETDASH_API_URLAPI base URL.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium, from $4.9 a month

Free for 5 sources; Pro $4.90/month or $29.90/year

Prices change. Check widgetdash.app before you buy.

WidgetDash 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 to WidgetDash

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  3. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  4. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  5. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  6. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data