mcp-timer 0.2.0

MCP Timer Server - Wait and scheduled timing tools for AI agents

mcp-timer

MCP Timer Server - Wait and scheduled timing tools for AI agents.

Installation

uvx mcp-timer

Tools

• wait(seconds) - Wait for specified seconds
• wait_until(target_time, next_day_if_passed=False) - Wait until specified time (HH:MM:SS or YYYY-MM-DD HH:MM:SS)
• cron_wait(expression, timeout_seconds=86400) - Wait until next cron expression match

cron_wait examples

*/5 * * * *      - every 5 minutes
0 9 * * MON-FRI  - 9:00 AM on weekdays
30 */2 * * *     - half past every 2 hours
0 0 1 * *       - midnight on the 1st of each month

MCP Configuration

{
  "mcpServers": {
    "timer": {
      "command": "uvx",
      "args": ["mcp-timer"]
    }
  }
}

Release

Publishing is automated via GitHub Actions. To release:

git tag v0.2.0
git push origin v0.2.0

This triggers the workflow to build and publish to PyPI using trusted publishing.

PyPI Setup (one-time)

1. Go to https://pypi.org/manage/project/mcp-timer/settings/publishing/
2. Add a new trusted publisher:
   • Workflow: publish.yml
   • Environment: pypi
   • Repository: aleck31/mcp-timer

License

MIT