How do I use opensprinkler-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@opensprinkler-mcp run station 0 for 10 minutes" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

opensprinkler-mcp

by Lumeo-sd

Overview Schema Related Servers Score Discussions

JavaScript

Remote

OpenSprinkler MCP Server

MCP server for managing OpenSprinkler controllers via Claude Desktop.

Available Tools

Tool	Description
`get_controller_status`	Get controller status (device time, enabled state, rain delay)
`get_stations`	Get all stations with their current status
`run_station`	Start a station for a specified duration
`stop_station`	Stop a running station
`stop_all_stations`	Stop all running stations immediately
`set_rain_delay`	Set rain delay in hours (0 to clear)
`enable_controller`	Enable or disable the controller
`reboot_controller`	Reboot the OpenSprinkler controller
`get_programs`	Get all watering programs
`get_options`	Get controller options and settings

Related MCP server: CNCjs MCP Server

Configuration

Environment Variables

Variable	Description	Default
`OPEN_SPRINKLER_HOST`	IP address of OpenSprinkler	localhost
`OPEN_SPRINKLER_PASSWORD`	Password (plain text or MD5 hash)	(empty)
`OPEN_SPRINKLER_PORT`	HTTP port	80

Docker

Build Image

docker build -t opensprinkler-mcp .

Run Manually (Test)

docker run -i --rm ^
  -e OPEN_SPRINKLER_HOST=192.168.1.100 ^
  -e OPEN_SPRINKLER_PASSWORD=your_password ^
  opensprinkler-mcp

Windows (PowerShell):

docker run -i --rm `
  -e OPEN_SPRINKLER_HOST=192.168.1.100 `
  -e OPEN_SPRINKLER_PASSWORD=your_password `
  opensprinkler-mcp

Linux/Mac:

docker run -i --rm \
  -e OPEN_SPRINKLER_HOST=192.168.1.100 \
  -e OPEN_SPRINKLER_PASSWORD=your_password \
  opensprinkler-mcp

Auto-Start Options

Option 1: Docker Compose (Recommended)

Create docker-compose.yml:

version: '3.8'

services:
  opensprinkler-mcp:
    image: opensprinkler-mcp
    container_name: opensprinkler-mcp
    restart: unless-stopped
    environment:
      - OPEN_SPRINKLER_HOST=192.168.1.100
      - OPEN_SPRINKLER_PASSWORD=your_password

Start:

docker compose up -d

Option 2: Docker Run with Restart

docker run -d --name opensprinkler-mcp ^
  --restart unless-stopped ^
  -e OPEN_SPRINKLER_HOST=192.168.1.100 ^
  -e OPEN_SPRINKLER_PASSWORD=your_password ^
  opensprinkler-mcp

Claude Desktop Configuration

Add to your claude_desktop_config.json:

Windows

%APPDATA%\Claude\claude_desktop_config.json

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

Docker (Recommended)

{
  "mcpServers": {
    "opensprinkler": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "OPEN_SPRINKLER_HOST=192.168.1.100",
        "-e",
        "OPEN_SPRINKLER_PASSWORD=your_password",
        "opensprinkler-mcp"
      ]
    }
  }
}

Pre-built Container (with auto-restart)

{
  "mcpServers": {
    "opensprinkler": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-e",
        "OPEN_SPRINKLER_HOST=192.168.1.100",
        "-e",
        "OPEN_SPRINKLER_PASSWORD=your_password",
        "opensprinkler-mcp"
      ]
    }
  }
}

Examples

Get all stations status

What stations are currently running?

Start a station

Run station 0 for 10 minutes

Set rain delay

Set 24 hour rain delay

Password

The OpenSprinkler API accepts both plain text passwords and MD5 hashes. You can generate an MD5 hash online or use the plain text password directly.

Troubleshooting

"Server disconnected" error

This usually means the MCP server is not running or not accessible. Try:

Test Docker manually:

docker run -i --rm ^
  -e OPEN_SPRINKLER_HOST=YOUR_IP ^
  -e OPEN_SPRINKLER_PASSWORD=YOUR_PASSWORD ^
  opensprinkler-mcp

If it runs without errors, press Ctrl+C to stop.

Check your IP address - make sure OpenSprinkler is reachable from your computer.
Restart Claude Desktop after changing configuration.

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Lumeo-sd/opensprinkler-mcp-sdr'

If you have feedback or need assistance with the MCP directory API, please join our Discord server