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/mcpAdd to Settings → Connectors → Add custom connector
https://app.getgumball.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"gumball": {
"url": "https://app.getgumball.com/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools