com.whenna/whenna

Official7 tools

Whenna

Group scheduling: create a plan link, mark availability, get best times, lock the final time.

Group scheduling tool that finds optimal meeting times from participant availability.

Captured live from the server via tools/list.

whenna_create_plan

Create a Whenna plan (a shareable link that finds the time everyone is free). Returns the link to share with humans or other agents, and a creator_key that authorizes locking the final time. Times are wall-clock in the given IANA timezone. For a RECURRING plan ("every Tuesday"), pass weekday names in days (e.g. ["Tuesday"] or ["Tue","Thu"]) — the plan then has no dates and calendar events repeat weekly.

Parameters (11)

titlestringrequired
What the plan is, e.g. "Team dinner"
daysarrayrequired
Candidate days: YYYY-MM-DD dates; OR weekday names (Mon…Sun) for weekly; OR ["daily"]; OR for monthly a single rule like ["15"] (day of month) or ["2nd Wednesday"] / ["last Friday"]. Do not mix forms.
frequencystring
How a recurring plan repeats. monthly requires days to be one rule: a day-of-month ("15") or an nth weekday ("2nd Wednesday", "last Friday"). Default weekly.
start_hourintegerrequired
Earliest hour to consider (0-23)
end_hourintegerrequired
Latest hour to consider (1-24, exclusive)
timezonestring
IANA timezone, e.g. America/Chicago
slot_minutesinteger
Time-slot precision
locationstring
Optional place ("Nonna's, 5th Ave") — shown on the plan and embedded in everyone's calendar event
every_weeksinteger
Repeat interval for recurring plans (with frequency: 2+weekly = every other week, 2+monthly = every other month, 3+daily = every 3 days)
notify_emailstring
Optional creator email: gets an alert on the first answer, digests after, a "everyone's free" moment, and the lock confirmation. Every email has one-click unsubscribe.
languagestring
Optional 2-letter language for emails to notify_email (en es pt fr de it nl ru tr id hi ja ko zh ar). Default en.

whenna_get_plan

Fetch a Whenna plan: title, window, every participant's availability, ranked best times, the locked final time if set, and a negotiation brief — state (awaiting_answers | collecting | everyone_overlaps | locked), who has answered, and suggested_next_step telling an agent the best next move. Poll this between actions when coordinating.

Parameters (1)

idstringrequired
Plan id (the part after /o/ in the link)

whenna_mark_availability

Set a participant's free times on a plan (replaces that participant's previous answer). Express availability as free ranges per day; the server converts them to slots. Use the participant's human name so the group recognizes them. An EMPTY free array records an explicit "can't make any of these times" (the group sees a ✗); pass withdraw:true instead to remove the answer entirely, as if never given. The result reports any ranges that could not be applied and why.

Parameters (4)

idstringrequired
namestringrequired
Participant display name
freearray
Free ranges. Empty array = explicit "can't make any".
withdrawboolean
Remove this participant's answer entirely (ignores free).

whenna_set_place

Set where the group meets: a place name, or video_call:true to attach Whenna's built-in encrypted video room (the room link then goes on everyone's calendar automatically). Place and video room are mutually exclusive. Requires creator_key.

Parameters (4)

idstringrequired
creator_keystringrequired
locationstring
Place name, e.g. "Nonna's, 5th Ave". Empty string clears it.
video_callboolean
true = meet on Whenna's encrypted video room instead of a physical place

whenna_plan_next

Group memory: start the group's next plan from a finished one. Clones the setup (title, hours, place/video, discussion), proposes the next occurrences of the locked weekday as candidate days, links old→new (the old link shows everyone "the next one is live"), and emails the people who opted in to hear about this group's next plans. Requires creator_key. Returns the new plan and its own creator_key — keep it to lock the new time. Idempotent: if a successor already exists it is returned.

Parameters (2)

idstringrequired
creator_keystringrequired

whenna_best_times

Ranked best meeting times for a plan: contiguous blocks where the most participants are free, with who is free in each block.

Parameters (2)

idstringrequired
topinteger

whenna_lock_time

Lock the final time on a plan (requires the creator_key returned by whenna_create_plan). Pass use_best:true to lock the top-ranked best time automatically, or give an explicit day/start. Everyone viewing the link sees it as confirmed, with add-to-calendar buttons. Returns calendar links (Google, Outlook, .ics).

Parameters (6)

idstringrequired
creator_keystringrequired
use_bestboolean
Lock the current #1 best time (most participants free); day/start not needed.
daystring
YYYY-MM-DD date, or a weekday name for weekly plans (matching the plan's days)
startstring
Start time HH:MM (24h, plan timezone)
minutesinteger
Duration in minutes

Install

claude_desktop_config.json

{
  "mcpServers": {
    "whenna": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://whenna.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.