User Steps

Provides a step-by-step, interactive checklist tool to guide users through manual tasks via Claude.

typescript

0

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "nedak23-user-steps-mcp": {
      "command": "node",
      "args": [
        "/path/to/user-steps-mcp/dist/index.js"
      ]
    }
  }
}

You can run the User Steps MCP Server locally to guide Claude users through step-by-step checklists with an interactive terminal UI. It opens a dedicated checklist interface in a new terminal window and waits for you to complete or cancel steps, making complex, manual workflows more reliable and auditable.

How to use

When Claude needs a user to perform manual steps, you will invoke the user_steps MCP tool. It automatically opens an interactive checklist UI in a new terminal window. You navigate the list to complete steps, skip steps if allowed, add notes, and finally finish or cancel the session. The companion terminal controls let you move through steps, toggle completion, skip steps, add feedback, and cancel when needed.

How to install

Prerequisites: you need Node.js and npm installed on your machine. Ensure you have a working shell and permissions to install packages.

# 1. Build the packages
cd user-steps-mcp
npm install
npm run build

cd cli
npm install
npm run build

Configuration and usage notes

Configure Claude Code to include the User Steps MCP server so Claude can load and run it when needed. You have three options to configure the MCP server.

# Option A: Project-level config
{
  "mcpServers": {
    "user-steps": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/user-steps-mcp/dist/index.js"]
    }
  }
}

# Option B: Global config
{
  "mcpServers": {
    "user-steps": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/user-steps-mcp/dist/index.js"]
    }
  }
}

# Option C: Via Claude CLI
claude mcp add user-steps node /path/to/user-steps-mcp/dist/index.js

Companion CLI Controls

Use the following keys inside the interactive terminal UI to manage the checklist.

| Key | Action |
|-----|--------|
| ↑/↓ | Navigate steps |
| Space/Enter | Toggle step completion |
| s | Toggle skip step |
| f | Add feedback/notes to step |
| c | Cancel session |

Available tools

user_steps

Offers a step-by-step interactive checklist UI that Claude can present to users, enabling guided completion of manual tasks with optional notes and a cancel option.