Reclaim MCP Server vs Timergy

create_poll

Create a Timergy scheduling poll (like Doodle) where participants vote on preferred time slots. Provide a title and at least 2-5 time slot options with ISO 8601 date-times (include timezone, e.g. 2026-03-20T18:00:00+02:00 or use UTC with Z suffix). Returns a shareable URL to send to participants and a passphrase for admin access. The passphrase is automatically remembered for finalize_poll. If an API key or OAuth token is configured, the poll is created on the user's account instead (no passphrase; update_poll, invite_to_poll, list_my_polls and finalize work via the same auth). Set autoFinalize=true with a deadline to automatically pick the best option when the deadline passes. Use invitees to send email invitations with direct voting links. Workflow: create_poll -> share URL -> wait for votes -> get_results -> finalize_poll (or use auto-finalize).

get_poll

Get poll metadata and time slot options (but NOT votes). Returns title, status, deadline, location, and all available time slots with their option IDs. Use this to retrieve optionId values needed for vote_on_poll or finalize_poll. To see who voted, use get_results instead.

vote_on_poll

Submit votes on a Timergy poll. First call get_poll to retrieve the available optionId values. Each vote maps an optionId to an availability: 'yes' (available), 'maybe' (might work), or 'no' (unavailable). A unique voter token is auto-generated per voter name. Resubmitting with the same voter name updates previous votes.

get_results

Get voting results for a Timergy poll, showing who voted yes/maybe/no for each time slot. Use this after participants have voted to see which slot has the most availability. To finalize, pick the optionId with the most 'yes' votes and call finalize_poll.

finalize_poll

Finalize a poll by picking the winning time slot. Call get_results first to find the best optionId. Uses the passphrase auto-saved from create_poll. If the MCP server was restarted since poll creation, provide the passphrase manually. Account-linked polls (created with API key/OAuth configured) have no passphrase; they are finalized via the same auth. This locks the poll and notifies participants who provided an email.

suggest_best_option

Analyze votes and suggest the best time slot for a poll. Returns all options ranked by score (yes=1, maybe=0.5). Tiebreaker: fewest no-votes, then earliest start. Use this before finalize_poll to let the AI pick the optimal slot, or to show the user a recommendation.

send_reminder

Send email reminders to poll participants who haven't voted yet. Requires the passphrase from create_poll (or API key/OAuth auth for account-linked polls). Only works for polls with invitations (email-based). Returns the number of emails sent and how many people already voted.

auto_finalize

Automatically finalize a poll by picking the best-scored time slot. Combines suggest_best_option + finalize_poll in one step. Requires the passphrase from create_poll (or API key/OAuth auth for account-linked polls). Notifies all participants.

check_conflicts

Check which poll time slots conflict with the creator's calendar events. Requires authentication via per-call oauthToken/apiKey, or pre-configured via --oauth-token/--api-key CLI flags. Returns each option with conflict status, conflicting event names, and conflictEventDetails (eventId, connectionId, provider) usable with ignore_event. Use this to help the creator avoid double-booking.

list_contacts

Search the user's Timergy address book by name or email. Use this before inviting people to find their email addresses. Contacts are auto-captured from invitations, votes, bookings, and Meeting Autopilot groups. Requires authentication via per-call oauthToken/apiKey, or pre-configured via --oauth-token/--api-key CLI flags. Optional query parameter to filter results.

invite_to_poll

Invite people to an existing poll by email. Use list_contacts first to find email addresses. Requires authentication via per-call oauthToken/apiKey, or pre-configured via --oauth-token/--api-key CLI flags. The poll must be open and owned by the authenticated user (create it with auth configured). Invitees receive an email with a direct voting link. Max 50 invitees per call.

create_survey

Create a Timergy survey (choice poll) where participants vote on text options instead of time slots. Provide a title and at least 2 text options (e.g. restaurant names, activity choices). Returns a shareable URL and a passphrase for admin access. Use for decisions like 'Where should we eat?', 'Which logo?', 'What activity?'. Workflow: create_survey -> share URL -> wait for votes -> get_results -> finalize_poll.