Heldly
io.heldly/scheduler
13 toolsHTTPregistry active
Summary
This connects Claude directly to your Google Calendar and turns natural language into booked meetings. You describe the meeting ("30-min discovery with sara@acme.com this week"), and it finds three free slots, places tentative holds on your calendar, and emails the invitee a picker. When they choose a time, it confirms that slot and clears the others automatically. No back-and-forth emails, no sending Calendly links, no manual cleanup. The whole flow happens through Claude: find_times checks availability, propose_meeting creates the holds, send_invitee_email delivers the picker. Built for customer-facing teams who spend half their day scheduling calls. Free tier covers 5 meetings per month.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
13 tools
find_timesPreview candidate meeting slots (no holds placed). Returns 3 slots labeled `1`, `2`, `3` chronologically, each with `previous_event` / `next_event` — the host's nearest events on either side, with gap + title. **Chat response — keep it SHORT and lead with the iframe.** The ifr...10 params
Preview candidate meeting slots (no holds placed). Returns 3 slots labeled `1`, `2`, `3` chronologically, each with `previous_event` / `next_event` — the host's nearest events on either side, with gap + title. **Chat response — keep it SHORT and lead with the iframe.** The ifr...
Parameters* required
window_endstringISO 8601 end of the search window.
duration_minvalueMeeting duration in minutes (30, 45, 60, or 90).
window_startstringISO 8601 start of the search window.
current_slotsarrayThe host's 3 currently-committed slot times, with their chronological labels (1 = earliest). Pass these in two situations: (a) alongside `propose_label` to propose a change to one slot while keeping the other two, (b) alone to commit a previously-proposed change (the new slot list replaces the previous one in the iframe). Pass the exact starts_at/ends_at values returned by the tool's previous call — don't reformat. Omit on the first call of a conversation.
propose_labelstringWhich committed slot (by chronological label) to re-pick a new time for. Requires `current_slots`. The two kept slots stay in `result.slots`; the new candidate appears in `result.proposed_slot.new` and renders as a visual diff overlay in the iframe (old faded + new emerald + dashed border). Narrow `window_start`/`window_end` to match the host's hint ("Friday morning" → that day's 9–12 window). Do NOT use this to commit — that's a separate call with updated `current_slots` and NO `propose_label`.one of
1 · 2 · 3co_host_emailsarrayOptional emails of workspace members who should also attend. Heldly intersects everyone's calendars so the returned slots work for all of you. Available on every plan.
invitee_timezonestringIANA timezone of the invitee (e.g. "Europe/Berlin", "America/New_York", "Asia/Tokyo"). When set, Heldly additionally requires each candidate to fall inside 9–17 M–F in the invitee's local time — so a Stockholm host meeting a Tokyo invitee gets only the narrow window that works for both parties. When omitted, Heldly filters by the host's tz only.
Don't infer from the email domain. Translate from whatever the host says in chat: a city ("Berlin" → "Europe/Berlin"), a country ("Sweden" → "Europe/Stockholm"), an offset ("6h behind me" → compute from host tz), or a region ("east coast US" → "America/New_York"). If the host says "doesn't matter" or "same as me", leave this absent.
target_starts_atstringOptional exact target time for the new candidate (ISO timestamp). Requires `current_slots` + `propose_label`. When set, the picker uses THIS time instead of running the bucket-rotation algorithm — the target is still validated against every constraint (workday hours, blackouts, invitee timezone, kept-slot overlap, host calendar conflicts, co-host busy). On failure, `proposed_slot.new` is null and `result.target_failure_reason` explains why. Two calling contexts: (a) the host clicks a target cell in the calendar iframe (a chat message of the form "Swap slot N to {weekday HH:MM} ({iso})" arrives — forward that ISO here); (b) the host names a specific time in chat ("swap slot 2 for Wed 3 PM") — convert to an ISO in the host's timezone and pass it here.
workday_end_hourintegerLatest acceptable hour of day, interpreted in the host's timezone (see /settings/profile). When omitted, Heldly uses the host's saved availability end hour (defaults to 17).
workday_start_hourintegerEarliest acceptable hour of day, interpreted in the host's timezone (see /settings/profile). When omitted, Heldly uses the host's saved availability start hour (defaults to 9). Pass explicitly only when the host narrows the moment ("book mornings only", "after 2pm").
propose_meetingPropose a meeting to an external invitee (anyone outside the host's workspace). Heldly places tentative holds on every host's Google Calendar synchronously and persists the meeting. When the invitee picks, Heldly confirms the chosen slot and deletes the siblings on every host'...16 params
Propose a meeting to an external invitee (anyone outside the host's workspace). Heldly places tentative holds on every host's Google Calendar synchronously and persists the meeting. When the invitee picks, Heldly confirms the chosen slot and deletes the siblings on every host'...
Parameters* required
slotsarrayExactly 3 candidate slots. Each slot's (ends_at - starts_at) must equal duration_min. Heldly places one tentative event per (slot × host) on each host's Google Calendar.
auto_sendbooleanDefaults to **false** — Heldly creates the meeting + places the holds, but does NOT email the invitee. After this tool returns, confirm the details with the host, then call `send_invitee_email`. Set this to true only if the host has already explicitly approved everything before you called.
host_namestringHost's full name. Defaults to your account name.
host_emailstringHost's email. Defaults to your account email.
window_endstringForward the `window.ends_at` value from your preceding `find_times` call. See `window_start`.
duration_minvalueMeeting duration in minutes (30, 45, 60, or 90).
host_messagestringOptional internal note saved on the meeting (not shown to the invitee).
invitee_namestringPrimary invitee's full name.
window_startstringForward the `window.starts_at` value from your preceding `find_times` call. Captures the host's intended booking window so that if the invitee can't make any of the proposed times, the picker's "None of these work" flow searches the right range. Falls back to the earliest slot start if omitted.
invitee_emailstringPrimary invitee's email. **Optional.** Provide it when you have it and Heldly will email the picker. Omit it for shareable mode — Heldly returns the picker URL and the host pastes it into Slack/LinkedIn/wherever; the invitee fills in their email on the picker page when they pick.
meeting_topicstringShort subject of the meeting. E.g. 'Discovery call', 'Demo follow-up', 'Q3 QBR', 'Renewal review'. Becomes the calendar invite title and the heading on the invitee's picker page. Do NOT include the invitee's name ("Discovery call with Adam" reads weird to Adam, who is reading it) or the host's name — neither party needs to be told who the meeting is with.
co_host_emailsarrayOptional emails of workspace members who should also attend. Heldly places holds on their calendars too, emails them they were added, and confirms / cleans up on their calendars when the invitee picks. They must (a) be in your workspace, (b) have calendar connected, (c) not have opted out of co-hosting. Available on every plan.
meeting_agendastringAgenda / context that goes into the calendar event description. The invitee will read this on the Google Calendar invite they receive after picking, so write in second person where natural ("We'll cover...") and skip the invitee's name — "learn about Adam's challenges" reads as third-person-about-Adam to Adam himself.
invitee_messagestringOptional personal note included in the invitee's picker email.
expiration_hoursvalueHours before the picker auto-expires if the invitee doesn't pick. Defaults to account default.
additional_invitee_emailsarrayOptional secondary invitees (up to 5). They're CC'd on the picker email and added to the Google Calendar event when the primary picks. Only the primary invitee can pick a slot. Use this for discovery/QBR calls where multiple people on the customer side should attend but one of them (typically the champion or main buyer) is choosing the time. Requires `invitee_email` — not compatible with shareable mode.
list_meetingsList meetings you've proposed or are co-hosting, most recent first. Use `query` to find a specific meeting by invitee, host, or topic. Each row includes a `picker_url` the host can paste into Slack / LinkedIn / a DM when the invitee says they never got the email — single-use,...4 params
List meetings you've proposed or are co-hosting, most recent first. Use `query` to find a specific meeting by invitee, host, or topic. Each row includes a `picker_url` the host can paste into Slack / LinkedIn / a DM when the invitee says they never got the email — single-use,...
Parameters* required
limitintegerDefault 20, max 100
querystringCase-insensitive substring match against invitee name/email, host name/email, and meeting topic.
statusstringFilter by statusone of
awaiting_invitee_pick · confirmed · expired · cancelledsince_daysintegerOnly include meetings updated in the last N days. In-flight meetings always come back regardless.
recent_inviteesReturn the host's recent invitees deduped by `invitee_email`, most-recent-first, each carrying the previous meeting's `last_meeting_topic` + `last_meeting_agenda` and `meeting_count`. Call this on any "book another with Sara" / "set up a follow-up with the Acme person" intent...2 params
Return the host's recent invitees deduped by `invitee_email`, most-recent-first, each carrying the previous meeting's `last_meeting_topic` + `last_meeting_agenda` and `meeting_count`. Call this on any "book another with Sara" / "set up a follow-up with the Acme person" intent...
Parameters* required
limitintegerDefault 20, max 25
querystringCase-insensitive substring match against `invitee_name` or `invitee_email`. Use whenever the host names a specific person.
get_meetingFetch the full details of a single meeting, including the timeline of events.1 params
Fetch the full details of a single meeting, including the timeline of events.
Parameters* required
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
check_meeting_statusQuick status snapshot of a single meeting — the right tool for "did Sara book?" / "is the Acme meeting confirmed?". Returns `status` + `hint`, the `booked_slot` (with pre-formatted local time) if one was picked, the invitee name, and onboarding narration when relevant. For ful...1 params
Quick status snapshot of a single meeting — the right tool for "did Sara book?" / "is the Acme meeting confirmed?". Returns `status` + `hint`, the `booked_slot` (with pre-formatted local time) if one was picked, the invitee name, and onboarding narration when relevant. For ful...
Parameters* required
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
send_invitee_emailSend the invitee picker email. This is both the **first-send** tool (after propose_meeting with auto_send=false, which is the default — call this once the host has confirmed the topic, agenda, and slots) AND the **resend / reminder** tool (if the host asks 'nudge Sara again')....1 params
Send the invitee picker email. This is both the **first-send** tool (after propose_meeting with auto_send=false, which is the default — call this once the host has confirmed the topic, agenda, and slots) AND the **resend / reminder** tool (if the host asks 'nudge Sara again')....
Parameters* required
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
cancel_meetingCancel a meeting. Heldly releases active picker slots and deletes every tentative or confirmed event we placed on any host's calendar — synchronously, in one call. The invitee gets a cancellation email if the meeting was already booked. Cannot cancel meetings that are already...2 params
Cancel a meeting. Heldly releases active picker slots and deletes every tentative or confirmed event we placed on any host's calendar — synchronously, in one call. The invitee gets a cancellation email if the meeting was already booked. Cannot cancel meetings that are already...
Parameters* required
reasonstringOptional reason — recorded on the timeline.
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
update_meeting_detailsEdit a meeting's topic, agenda, or invitee name WITHOUT re-emailing the invitee and WITHOUT changing any times. The right tool for typo fixes, agenda refinements, and correcting an invitee name the host wrote wrong. Allowed on `awaiting_invitee_pick` and `confirmed` meetings....4 params
Edit a meeting's topic, agenda, or invitee name WITHOUT re-emailing the invitee and WITHOUT changing any times. The right tool for typo fixes, agenda refinements, and correcting an invitee name the host wrote wrong. Allowed on `awaiting_invitee_pick` and `confirmed` meetings....
Parameters* required
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
invitee_namestringNew invitee display name (1–120 chars).
meeting_topicstringNew short subject of the meeting (1–120 chars). Keep names out — both parties read it.
meeting_agendastringNew agenda / description (1–4000 chars). Becomes the Google Calendar event description after patch.
add_co_hostAdd a workspace member as a co-host on an existing meeting without going through `reschedule_meeting` (which is heavy: deletes events + re-emails the invitee). The right tool for "actually loop Pat in on the Sara meeting too." Available on every plan. The new co-host must be a...2 params
Add a workspace member as a co-host on an existing meeting without going through `reschedule_meeting` (which is heavy: deletes events + re-emails the invitee). The right tool for "actually loop Pat in on the Sara meeting too." Available on every plan. The new co-host must be a...
Parameters* required
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
co_host_emailstringEmail of the workspace member to add as a co-host.
reschedule_meetingReschedule an existing meeting to new slots. Works for both: • `confirmed` meetings — Heldly deletes the booked event on every host's calendar, places fresh tentatives on the new slots, flips status back to awaiting_invitee_pick, and emails the invitee a 'moved to...' picker....6 params
Reschedule an existing meeting to new slots. Works for both: • `confirmed` meetings — Heldly deletes the booked event on every host's calendar, places fresh tentatives on the new slots, flips status back to awaiting_invitee_pick, and emails the invitee a 'moved to...' picker....
Parameters* required
slotsarrayExactly 3 new candidate slots. Each slot's duration must match the original meeting's `duration_min`.
reasonstringOptional host-supplied reason shown to the invitee in the 'moved to...' email body. E.g. 'Anna had a conflict come up — here are some other times that work.'
meeting_idstringThe meeting's id, as returned by `propose_meeting`, `list_meetings`, or `recent_invitees`.
window_endstringForward `window.ends_at` from your preceding `find_times` call.
window_startstringForward `window.starts_at` from your preceding `find_times` call. Captures the host's intended window for the rescheduled meeting so the picker's "None of these work" flow searches the right range.
notify_inviteebooleanDefaults to true: Heldly immediately emails the invitee the new picker. Set false to let the host preview the new state and call send_invitee_email manually.
invite_workspace_memberInvite a new member to your Heldly workspace (Business plan, admin only). Use this when the host wants to co-host a meeting with someone who isn't in the workspace yet — find_times and propose_meeting return `co_host_not_in_workspace` for those emails. The invitee receives an...3 params
Invite a new member to your Heldly workspace (Business plan, admin only). Use this when the host wants to co-host a meeting with someone who isn't in the workspace yet — find_times and propose_meeting return `co_host_not_in_workspace` for those emails. The invitee receives an...
Parameters* required
notestringOptional note appended to the invite email (currently ignored — reserved for future use).
rolestringWorkspace role — defaults to 'member'. Use 'admin' only when the host explicitly asks.one of
member · adminemailstringEmail of the person to invite.
get_workspace_insightsWorkspace-wide insights for managers (Team admins only). Returns the funnel (proposed → opened → picked → confirmed), per-week volume, and time-to-pick percentiles. Use when the host asks any of: • 'how many meetings did the team book last week?' • 'what's our pick rate this q...2 params
Workspace-wide insights for managers (Team admins only). Returns the funnel (proposed → opened → picked → confirmed), per-week volume, and time-to-pick percentiles. Use when the host asks any of: • 'how many meetings did the team book last week?' • 'what's our pick rate this q...
Parameters* required
metricstringOptional focus. Defaults to 'all' (returns the full bundle). Use a single metric when the host asks about one specific thing.one of
funnel · volume · time_to_pick · allsince_daysintegerWindow size in days. Defaults to 30.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →