Skip to content
MCP serverOfficial: Published to the official MCP Registry by the GitHub account or domain it is named after, which owns its code or website.

wheelfor

MCP server that creates, spins and edits shareable decision wheels from AI clients

Runs locally
Install

wheelfor is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, Web
Runs
Locally
Version
1.0.1
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add mcp -- npx -y @wheelfor/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wheelfor/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wheelfor/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@wheelfor/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wheelfor/mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@wheelfor/mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About wheelfor

The README says this server connects AI assistants such as Claude Desktop, Cursor, Windsurf and VS Code to wheelfor.com, a site for building shareable random-pick wheels. An assistant can turn a list of options into a wheel, draw a random winner, or do both at once when a quick choice needs to be kept for later.

The server runs locally over stdio and is installed through npx from the @wheelfor/mcp npm package. Each wheel gets a public URL that others can spin, and wheels created with a edit key can later be renamed, re-themed or have their choices changed by supplying that key.

It suits people who want a fast, shareable way to settle small group decisions such as team retrospectives, lunch picks or framework choices without leaving their chat or editor.

Tools this server provides (4)

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

create_wheel
Create a new spinning wheel from a list of options
spin_wheel
Spin an existing wheel and get a random result with a shareable URL
update_wheel
Update a wheel's choices, name, or theme using its edit key
decide
Pick randomly from a list and create a permanent wheel in one step

What it does

Create spinning wheels
Builds a wheel from a list of choices with a name, description and visual theme.
Spin for a random result
Draws a random winner from an existing wheel and returns a shareable result link.
Quick decide in one step
Picks a random option immediately and saves it as a permanent wheel.
Edit with an edit key
Updates a wheel's choices, name, theme or description when the creation edit key is supplied.
Theme and visitor hints
Accepts a visual theme and optional usage hint and noun labels for each wheel.

Good for

  • Settling a quick team decision between a few named options
  • Running a retro exercise with a shareable wheel for the group
  • Choosing where to eat from a saved wheel that others can spin
  • Letting an AI assistant maintain and update a shared list of options

Pricing

Open source

Free MIT-licensed npm package.

wheelfor FAQ

Does wheelfor require an account?

The README says no account is required.

Which AI clients are supported?

The README names Claude Desktop, Cursor, Windsurf and VS Code, and says it works with any other MCP host.

How do I edit a wheel after creating wheelfor?

The update_wheel tool requires the slug and the edit key returned when the wheel was created.

Is wheelfor free?

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

How do I add wheelfor to Claude Code?

Run this command in your terminal: claude mcp add mcp -- npx -y @wheelfor/mcp

What are the best alternatives to wheelfor?

The closest alternatives to wheelfor are NameWheel, SpinTheWheel Hub and Sparkler.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers