Content
Moduui Timer MCP
This is an MCP server thatClaude to directly create and control** [Moduui Timer](https-timer-d07t.onrender.com).
You can say to Claude:
- "Create a 5-minute" → A viewer link will be generated
- "Start the timer"Add 1 minute"Display 'Get ready to start' on the screen"
- "Open a lunch menu vote. Jjaj Jjamppong" / "How many votes now?" / "Reveal the- "Open a hand-raising game" / "Give me a quiz. The answer is 2"
---
## Tool List
**Timers)**
| Tool | Description |
|| `create_timer` | Create timer + **auto-popup admin screen** (issue viewer and controller |
| `open_controller` / `open_viewer` | Open viewer screens in this PC browser |
| `get_timer_state` | Read and state (no token |
| `start_timer`pause_timer` / `reset_timer` | Start / pause / reset |
adjust_timer` | Adjust remaining time ± seconds |
| `show_message` / `clear_message` | Display a message on the screen / clear |
schedule_start` / `cancel_scheduled_start` | Schedule automatic start at a specified time / cancel |
| `schedule_add` / `schedule_remove` | remove scheduled messages — message automatically when the remaining time seconds |
**Polls and Hand-Raising (6)** — Viewers participate with their phones, and the presenter sees the results
| Tool | Description---|---|
| `open_poll` | Open a choice poll ( 2-4 options, real-time aggregation) |
| `open` | Open a hand-raising game (list of 1 10th participants in order) |
| `open_qu | Open a hand-raising quiz (ranked by speed of correct answer hidden until revealed) |
| `get_poll_results` | Read real-time aggregation and ranking (for presenters) |
| `reveal_poll_results` | Toggle reveal / hide results for viewers |
| `close_poll` | End and fix results |
---
## How it Works
- **Timer creation** is done via HTTP (`POST /create`).
- **Timer control** (start, pause, reset, etc.) is done via sockets (socket.io).
This is a **thin wrapper** commands to an existing Mod Timer server. No separate server deployment is required, and it runs local PC.
---
## Installation
```bash
# Python 10 or higher required
pip install -r requirements.txt
```
## Claude Desktop
Add the following to your `claude_desktop_config.json` file under `mcpServers`:
(`/absolute/path/` should be actual path to the filejson
{
"Servers": {
"moduui-timer": {
"command": "python",
"args": ["/absolute/path/timer_mcp.py"],
"env": { "TIMER_BASE_URL": "https-timer-d07t.onrender.com" }
}
Restart Claude Desktop after setting this up and say:
> "Create3-minute timer for presentation"
⚠️ Important Notes
- is the 'control password'**. When you create a timer, `room_id` and `token`. Only share the viewer link (`viewer_url`) with others, and keep the controller link (with token.
- **This MCP connects to the render server by default**. If you run your own server, change the `TIMER_BASE_URL` environment your server's address.
-_add` time format** — an integer representing the remaining time in seconds by server measurement). Example60` displays the message when 1 minute remains. Time strings (e.g., `"15:00"`) are ignored by the server.schedule_start` (with epoch to start at a specific time **Free hosting characteristics** — server uses a free render which may sleep after 15 minutes of inactivity and take around to respond to the first request. Retry if a tool call times---
## License
MIT License — Feel free to use, modify, and share. (See `LICENSE)
