rmcp-breakrs

Crates.iormcp-breakrs
lib.rsrmcp-breakrs
version0.1.0
created_at2026-01-06 17:53:20.242847+00
updated_at2026-01-06 17:53:20.242847+00
descriptionMCP server for breakrs - AI-powered desktop notifications and reminders
homepage
repositoryhttps://github.com/sqrew/rmcp-breakrs
max_upload_size
id2026406
size42,091
sqrew (sqrew)

documentation

README

rmcp-breakrs

MCP server for breakrs - give your AI the ability to schedule desktop notifications.

Why?

Every AI assistant can say "I'll remind you in 30 minutes" - but they're lying. They can't actually do it.

This one can.

rmcp-breakrs gives AI temporal agency. Your AI can now schedule real notifications that fire when you need them, manage a queue of reminders, and proactively reach out through time.

Features

Tool Description
set_reminder Schedule notifications with natural language ("5m get coffee", "1h meeting")
list_reminders See all pending reminders
remove_reminder Cancel a specific reminder
get_history See recently completed reminders
clear_reminders Clear all pending reminders
daemon_status Check if breakrs daemon is running

Installation

Prerequisites

Install breakrs first:

cargo install breakrs

Install rmcp-breakrs

cargo install rmcp-breakrs

Configuration

Add to your Claude Code MCP config (~/.claude.json):

{
  "mcpServers": {
    "breakrs": {
      "type": "stdio",
      "command": "rmcp-breakrs",
      "args": [],
      "env": {}
    }
  }
}

Restart Claude Code. Your AI now has time powers.

Usage

Once configured, your AI can:

"Set a reminder in 30 minutes to check on the build"
→ Timer #1 set for "check on the build" (30 minutes)

"What reminders do I have pending?"
→ Active timers:
   #1: "check on the build" - 28m remaining

"Cancel reminder #1"
→ Removed reminder #1

Reminder Options

  • Natural language durations: 5m, 1h 30m, 2:30:00, five minutes
  • Urgent notifications: --urgent flag for critical alerts
  • Sound: --sound flag for audio notification
  • Recurring: --recurring flag for repeating timers

Use Cases

  • Accountability: AI reminds you to eat, hydrate, take breaks
  • Workflow: Set reminders for async tasks (builds, deploys, PR reviews)
  • Proactive AI: Your AI can now schedule its own check-ins
  • Time-boxing: AI helps enforce work/break cycles

How It Works

rmcp-breakrs wraps the breakrs CLI as an MCP server. When your AI calls set_reminder, it runs breakrs <duration> <message> which schedules a desktop notification through your system's notification daemon.

No cloud. No API keys. Just local notifications.

Related

License

MIT

Commit count: 1

cargo fmt