@sidebutton/server

SideButton server with MCP integration, REST API, and web dashboard for workflow automation.

Installation

npm install @sidebutton/server

Quick Start

# Start the server
npx sidebutton

# Open http://localhost:9876

Features

• Web Dashboard - Visual workflow management UI
• MCP Server - Model Context Protocol for AI agents (Claude Code, Cursor)
• REST API - JSON endpoints for mobile and external integrations
• Chrome Extension - Browser automation via WebSocket
• CLI - Command-line interface for workflow management

CLI Commands

sidebutton                    # Start server on port 9876 (default)
sidebutton --stdio            # Start with stdio transport (for Claude Desktop)
sidebutton -p 8080            # Start on custom port
sidebutton list               # List available workflows
sidebutton run <id>           # Run a workflow by ID
sidebutton status             # Check server status

# Skill pack registries
sidebutton registry add <path|url>   # Register + install all skill packs
sidebutton registry update [name]    # Update installed packs from registry
sidebutton registry remove <name>    # Uninstall packs and remove registry
sidebutton registry list             # Show registries and pack counts
sidebutton search [query]            # Search packs across registries
sidebutton install <path|url|name>   # One-off skill pack install
sidebutton uninstall <domain>        # Remove an installed skill pack

MCP Integration

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "sidebutton": {
      "command": "npx",
      "args": ["sidebutton", "--stdio"]
    }
  }
}

Note: The --stdio flag uses stdin/stdout for MCP communication, which is required for Claude Desktop's JSON config. The HTTP server still runs in the background for browser extension connectivity.

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "sidebutton": {
      "type": "sse",
      "url": "http://localhost:9876/mcp"
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "sidebutton": {
      "url": "http://localhost:9876/mcp"
    }
  }
}

MCP Tools

| Tool | Description | |------|-------------| | run_workflow | Execute a workflow by ID | | list_workflows | List available workflows | | get_workflow | Get workflow YAML definition | | get_run_log | Get execution log | | list_run_logs | List recent executions | | get_browser_status | Check extension connection | | capture_page | Capture page selectors | | navigate | Navigate browser to URL | | snapshot | Get accessibility tree | | click | Click element | | type | Type text | | scroll | Scroll page | | extract | Extract text | | screenshot | Capture screenshot | | hover | Hover over element |

Documentation

• Full Documentation
• GitHub Repository
• Website

Related Packages

• @sidebutton/core - Core workflow engine

License

Apache-2.0