# wheelfor

> wheelfor is an open-source MCP server for productivity. MCP server that creates, spins and edits shareable decision wheels from AI clients. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web, VS Code
- **Repository:** https://github.com/wheelfor/mcp
- **MCP Registry name:** io.github.wheelfor/mcp
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-21

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

- `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

## 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.

## Alternatives

- [NameWheel](https://ai-powered.com/mcp/namewheel): NameWheel is a freemium MCP server for productivity.
- [SpinTheWheel Hub](https://ai-powered.com/mcp/spinthewheel-hub): SpinTheWheel Hub is a free MCP server for games and play.
- [Sparkler](https://ai-powered.com/mcp/sparkler): Sparkler is a freemium MCP server for productivity.

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