Skip to content
MCP server

Gumball

Ring, mute and set the volume of a real WiFi siren light from your AI agent

Pricing
Open source
Platforms
API, CLI
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About Gumball

Gumball is an open-source MCP server for smart home. It runs as a hosted remote server, so there is nothing to install locally.

This server controls a physical device. Gumball is a WiFi revolving light with a speaker that goes off when something happens, such as a sale, a new user or a deploy. Through MCP an assistant can list your Gumballs, spin one with a chosen sound (0 is light only), play a random sound in a range, set the volume from 0 to 21, and mute or unmute it. With several devices, the agent picks one by name. It cannot change your WiFi, firmware or passwords.

You sign in to a Gumball account, make a named token, and use it either as a Bearer header or inside the address. The address with the token acts like a password. Every agent action is logged against the token's name in the device's activity list, and the limit is 30 actions a minute per token.

A command-line tool, getgumball, talks to the same endpoint. One command, npx getgumball claude-code, adds Claude Code hooks that ring a sound when a task of 30 seconds or more finishes and a different one when Claude needs you, and a short GitHub Actions snippet rings on deploy success or failure. The MCP server is hosted, MIT licensed and made in Montreal by Thinkmojo.

Install

Run in a terminal

claude mcp add --transport http gumball https://app.getgumball.com/mcp

Add to Settings → Connectors → Add custom connector

https://app.getgumball.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gumball": {
      "url": "https://app.getgumball.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gumball": {
      "type": "http",
      "url": "https://app.getgumball.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "gumball": {
      "serverUrl": "https://app.getgumball.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "gumball": {
      "type": "http",
      "url": "https://app.getgumball.com/mcp"
    }
  }
}

Tools this server provides (6)

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

list_gumballs
Lists your Gumballs with name, ID and online status.
ring_gumball
Spins the light and plays a sound; sound 0 is light only.
play_random_sound
Plays a random sound in a given range.
set_volume
Sets volume from 0 to 21.
mute_gumball
Puts the device in sleep mode, ignoring notifications.
unmute_gumball
Returns the device to normal.

What it does

Ring on demand
Spins the light and plays a numbered sound, or light only.
Volume and mute
Sets volume 0 to 21 and mutes or unmutes notifications.
Multiple devices
Targets a specific Gumball by name or ID.
Per-token activity log
Shows every agent action with the token's name.
Claude Code hooks
One command rings the light when a long task ends or needs input.
CI integration
Ring from GitHub Actions on deploy success or failure.

Good for

  • Get a physical alert when a long Claude Code task finishes
  • Signal a failed build or successful deploy in the office
  • Silence the office light until tomorrow by asking an assistant
  • Play a celebration sound when tests pass

Pricing

Open source

MCP server is MIT licensed; requires a Gumball device and account

Prices change. Check getgumball.com before you buy.

Gumball FAQ

What do I need?

A Gumball device, a Gumball account and a token made on the AI agents page.

Is there a rate limit?

Yes, 30 actions a minute per token.

How do I revoke access?

Delete the token on your account page; one token per app lets you cut off one without affecting others.

Can ChatGPT ring it?

The site says ringing is a write action that OpenAI does not allow on every plan yet.

Is Gumball free?

Yes. Gumball is open source, so you can use and self-host it for free.

How do I add Gumball to Claude Code?

Run this command in your terminal: claude mcp add --transport http gumball https://app.getgumball.com/mcp

What are the best alternatives to Gumball?

The closest alternatives to Gumball are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Gumball

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools