Laundry Timer

Provides laundry planning data sources and actions to determine optimal washing and drying times.

python

1

GitHub Stars

python

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": {
    "nicolavs-laundry-timer-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/laundry-timer-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

You can run a lightweight MCP (Model Context Protocol) server to help plan laundry tasks by querying preferences and real-time forecasts. This server focuses on suggesting when to wash or air-dry clothes, making laundry planning smarter and more efficient.

How to use

You connect with an MCP client to the laundry planning server and ask natural language questions such as whether it is a good time to do laundry today in your location. The server uses available information about laundry preferences and current weather to provide actionable timing recommendations. You can ask for optimal moments to wash, dry, or line-dry based on forecasts and user goals.

How to install

Prerequisites you need before starting:

Python 3.8 or later
The UV runtime (used to run the MCP server) available on your system as the command uv

Install and run steps

Create a directory to hold the MCP server files and place the server script there.
Add the MCP server configuration snippet to your client configuration so the client can discover and connect to this server.
Start the MCP server runtime with the provided command

Example configuration for the MCP client

{
  "mcpServers": {
    "laundry_timer": {
      "command": "uv",
      "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/laundry-timer-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Start command example

Use the exact start command shown in the example to launch the MCP server through the runtime: uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/laundry-timer-mcp run server.py.

Notes

No additional tools or client-side steps are required beyond configuring the MCP server in your client and starting the runtime. This setup keeps laundry planning conversational and action-oriented while staying lightweight.