# ReminderIt

> Schedule real phone-call reminders with WhatsApp follow-up — medication, wake-ups, family check-ins.

- name: com.reminderit/reminderit
- version: 0.3.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 88/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.reminderit%2Freminderit
- tools: https://api.protogrid.dev/v1/servers/com.reminderit%2Freminderit/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "reminderit": {
      "type": "http",
      "url": "https://mcp.reminderit.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 99
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-97% +updated-20d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 88/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 25 of 25 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 5,586 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 25, about 5,586 tokens to load them all
- tool set hash: 816e4d779d9b324ab964755db9e3c424
- badge: [![protogrid quality](https://protogrid.dev/badge/com.reminderit/reminderit.svg)](https://protogrid.dev/servers/com.reminderit/reminderit)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://mcp.reminderit.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.97402596)

## Packages

_none_

## Tools (25)

- `add_recipient`: Add another person who can receive reminder calls, e.g. an elderly parent.

    ReminderIt immediately places a consent verification call to the number; reminders
    are only delivered after that person accepts. Only add someone the user genuinely
    has permission to call, and confirm the number digit by digit before submitting —
    a typo calls a stranger.

    Args:
        name: The person's name, used in the call greeting.
        phone: Their number in full E.164 format, e.g. "+447700900123".
        relationship: Optional label for the user's own reference, e.g. "Mother".
    
- `clear_reminder_voice`: Remove a reminder's custom voice so it uses the account default again.

    Args:
        reminder_id: Reminder whose voice override should be cleared.
    
- `create_reminder`: Schedule a new reminder phone call.

    This places REAL calls, so get the schedule right the first time: resolve the
    timezone via whoami, and read the result back to the user afterwards.

    Provide exactly one schedule: run_at (one-off), cron_expr, or interval_days.
    Leave the voice arguments empty to use the account's default voice.

    Args:
        title: Short label shown in the app, e.g. "Morning pills" (max 120 chars).
        message_text: Exactly what the voice says on the call, written as speech —
            "Time to take your blood pressure tablet." (max 600 chars). Avoid
            abbreviations and symbols that sound wrong when read aloud.
        type: "once" for a single call, "recurring" for a repeating schedule.
        timezone: IANA timezone the schedule is anchored to, e.g. "America/New_York".
        run_at: ISO 8601 local datetime for a one-off call. Required when type="once".
        cron_expr: Cron schedule for recurring calls, e.g. "0 8 * * 1-5" = weekdays 8am.
        interval_days: Repeat every N days (1-365). Simpler alternative to cron_expr.
        start_date: ISO date; the recurring series does not fire before this.
        end_date: ISO date; the series stops after this (e.g. end of a medication course).
        skip_dates: Local dates to skip, ["2026-08-12"] format — holidays, travel.
        recipient_id: Call a care-recipient (from list_recipients) instead of the
            account owner. The recipient must have consented.
        voice_id: Override the account voice for this reminder only (see list_voices).
        personality: Speaking style — "gentle", "cheerful", "professional", "energetic".
        language: BCP-47 language tag for the spoken message, e.g. "en-GB", "hi-IN".
        speaking_rate: Speech speed, 0.8 (slower) to 1.2 (faster). 1.0 is normal.
        whatsapp_fallback: Send the reminder on WhatsApp if the call isn't answered.
        email_fallback: Also email the reminder if the call isn't answered.
    
- `delete_reminder`: Permanently delete a reminder. This cannot be undone.

    Confirm with the user first, quoting the reminder's title and schedule. If they may
    want it later, use pause_reminder instead.

    Args:
        reminder_id: Reminder to delete (from list_reminders).
    
- `get_recent_calls`: Show recent delivery history — what was actually called, sent, or missed.

    Use this to answer "did it call me?", "why didn't I get it?", or to confirm a
    reminder is really firing. Statuses: completed/answered = the person picked up;
    no-answer/busy = rang but nobody answered (a WhatsApp fallback usually follows);
    failed = the call could not be placed; blocked = suppressed before dialling (no
    credit, unsupported country, or a recipient who hasn't consented);
    sent/delivered/read = a WhatsApp or email fallback.

    Args:
        limit: Number of recent delivery records (1-50, default 10).
    
- `get_reminder`: Get the full configuration of one reminder as JSON.

    Use when you need detail that list_reminders omits — the exact spoken message,
    cron expression, skip dates, channel toggles, or voice override. Also use this to
    read current values before a partial update, so you don't overwrite settings.

    Args:
        reminder_id: Reminder ID from list_reminders.
    
- `get_usage`: Get remaining call quota, calls used, plan, and the current billing period.

    Check before creating several reminders or suggesting a test call, and whenever a
    delivery fails unexpectedly. One call OR one WhatsApp fallback each consume one
    unit from the same pool. When the balance is low or zero, tell the user plainly.
    
- `get_voice_settings`: Show the account's default voice — the voice every reminder uses unless overridden.

    Read this before changing anything, so you can report what actually changed and
    leave unrelated settings alone.
    
- `list_recipients`: List care-recipients — other people this account can send reminders to.

    Needed to get the recipient_id for create_reminder. Consent status matters: only
    "confirmed" recipients receive calls; "pending" means they haven't accepted the
    verification call yet, so reminders to them will be blocked.
    
- `list_reminders`: List every reminder on the account with its schedule, state and next call time.

    Start here for almost any request about existing reminders — it is the only way to
    discover reminder IDs, which every other reminder tool needs. Paused reminders show
    WHY they are paused (out_of_credit, destination_not_allowed, completed).
    
- `list_upcoming`: Show the next scheduled calls across ALL reminders, in chronological order.

    Answers "what's coming up?" better than list_reminders, because it expands
    recurring rules into actual upcoming occurrences and merges them into one timeline.

    Args:
        limit: How many upcoming occurrences to return (1-50, default 10).
    
- `list_voices`: List the voices available on this account, with language, accent and tier.

    Call before set_voice_settings or set_reminder_voice to get valid voice IDs —
    never guess one. Voices marked premium may not be included in every plan; if the
    account's plan doesn't include one, calls fall back to a standard voice.
    
- `pause_reminder`: Pause a reminder so it stops calling, keeping all its settings intact.

    Prefer this over delete_reminder whenever the user might want it back — it is
    fully reversible with resume_reminder.

    Args:
        reminder_id: Reminder to pause (from list_reminders).
    
- `preview_voice`: Generate a short audio sample of a voice so the user can hear it before choosing.

    Returns a URL to the generated audio. Useful when a user is deciding between
    voices, or wants to check how their own reminder wording will sound.

    Args:
        voice_id: Voice ID from list_voices.
        text: Words to speak in the sample. Defaults to a standard demo line; pass the
            user's actual reminder message to preview exactly what they'll hear.
        personality: "gentle", "cheerful", "professional", or "energetic".
        language: BCP-47 tag, e.g. "en-GB".
        speaking_rate: 0.8 to 1.2.
    
- `remove_recipient`: Remove a care-recipient from the account.

    Any reminders targeting them will stop being delivered. Confirm with the user first.

    Args:
        recipient_id: Recipient to remove (from list_recipients).
    
- `resend_recipient_verification`: Re-send the consent verification call to a recipient who hasn't confirmed yet.

    Use when list_recipients shows consent as pending and the person missed the first
    call. Don't repeat it more than necessary — each attempt rings their phone.

    Args:
        recipient_id: Recipient to re-verify (from list_recipients).
    
- `resume_reminder`: Resume a paused reminder so it starts calling on its schedule again.

    If it was paused automatically for out_of_credit and the account still has no calls
    left, it will pause again at the next occurrence — check get_usage and tell the user.

    Args:
        reminder_id: Reminder to resume (from list_reminders).
    
- `set_reminder_channels`: Choose what happens when a reminder call isn't answered.

    The phone call itself is always attempted. These toggles control the follow-ups:
    WhatsApp is on by default, email is off. Note each delivered fallback also consumes
    one call from the account's quota.

    Args:
        reminder_id: Reminder to configure (from list_reminders).
        whatsapp_fallback: True to send a WhatsApp message when the call is missed.
        email_fallback: True to also email the reminder when the call is missed.
    
- `set_reminder_voice`: Give one reminder its own voice, overriding the account default.

    Use when a specific reminder should sound different — a calm, slower voice for
    medication; an energetic one for a workout; a different language for a relative.
    Call list_voices first to get valid voice IDs, and preview_voice if the user
    wants to hear it before committing. Other reminders are unaffected.

    Args:
        reminder_id: Reminder to restyle (from list_reminders).
        voice_id: Voice ID from list_voices.
        personality: "gentle", "cheerful", "professional", or "energetic".
        language: BCP-47 tag for the spoken message, e.g. "en-GB", "es-ES", "hi-IN".
        speaking_rate: 0.8 (slower, good for elderly listeners) to 1.2 (faster).
    
- `set_skip_dates`: Set the specific dates a recurring reminder should NOT call.

    The right way to handle holidays, travel, or a pause of a few days — far better
    than deleting a reminder and rebuilding it. This REPLACES the existing skip list,
    so include dates the user still wants skipped (read them with get_reminder first).
    Pass an empty list to clear all skips.

    Args:
        reminder_id: Reminder to adjust (from list_reminders).
        skip_dates: Local dates in "YYYY-MM-DD" form, e.g. ["2026-08-12", "2026-08-13"].
    
- `set_voice_settings`: Change the account's DEFAULT voice, affecting every reminder without an override.

    For a single reminder only, use set_reminder_voice instead. Get valid IDs from
    list_voices; preview_voice lets the user hear one first.

    Args:
        voice_id: Voice ID from list_voices.
        personality: "gentle", "cheerful", "professional", or "energetic".
        language: BCP-47 tag, e.g. "en-US", "en-GB", "hi-IN".
        speaking_rate: 0.8 (slower — often better for elderly listeners) to 1.2 (faster).
        greet_by_name: Whether calls open by greeting the user by name.
    
- `skip_next_occurrence`: Skip only the next scheduled call, leaving the rest of the schedule untouched.

    Use for "not tomorrow, but keep it going after that". To skip particular calendar
    dates instead, use set_skip_dates.

    Args:
        reminder_id: Reminder whose next call should be skipped.
    
- `test_call`: Place an immediate test call for a reminder so the user can hear it right now.

    The phone will ring within seconds — only do this when the user has asked to test,
    and never repeatedly. It consumes one call from their quota and does not change
    the schedule.

    Args:
        reminder_id: Reminder to test (from list_reminders).
    
- `update_reminder`: Edit a reminder's wording or schedule. Only the fields you pass are changed.

    Use for "move it to 7am", "say it differently", "stop after the 20th". To pause or
    resume, use pause_reminder / resume_reminder. To change the voice, use
    set_reminder_voice. To skip particular dates, use set_skip_dates.

    Args:
        reminder_id: Reminder to edit (from list_reminders).
        title: New short label.
        message_text: New spoken message (written as natural speech, max 600 chars).
        cron_expr: New cron schedule, e.g. "0 7 * * *" for daily 7am.
        interval_days: New "every N days" interval (1-365).
        run_at: New ISO 8601 datetime for a one-off reminder.
        timezone: New IANA timezone. Changing this moves every future call.
        start_date: New ISO start date for a recurring series.
        end_date: New ISO end date; the series stops after it.
    
- `whoami`: Identify the connected ReminderIt account: who it is, their timezone, plan and quota.

    Two jobs. First, it is the connection check — call it when the user asks "am I
    connected?", "which account is this?", or when another tool returns an auth error,
    to confirm the API key is valid and see whose account it opens.

    Second, call it BEFORE creating or rescheduling a reminder: it returns the user's
    saved timezone, so you can schedule silently instead of asking. It also warns when
    the phone is unverified or the account is opted out — in either case no reminder can
    be delivered, so surface that before scheduling anything.
    
