findtime.io MCP Server
Server Details
MCP server for time in cities around the world, time zones, DST, conversion, and meetings.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- hkchao/findtime-mcp-server
- GitHub Stars
- 0
- Server Listing
- @findtime/mcp-server
- ChatGPT
- –
- Claude
- findtime.io
TDQS
Scored across 34 tools
Most tools have distinct roles (find_host_slots vs request_booking vs get_booking_status are clear), but the surface has real overlap zones: answer_time_question is a plain-language router that can do what get_current_time, convert_time, get_overlap_hours, are_they_awake, and find_meeting_time do individually, forcing an agent to guess which to call. cancel_booking vs cancel_booking_as_host, and list_booking_requests vs list_my_booking_requests, are separable only by careful reading of role framing. The descriptions do include cross-references ('does not perform conversions') that help, but the boundaries are not crisp.
Nearly every tool is snake_case verb_noun (get_current_time, create_invite_link, approve_booking_request, list_teams, delete_team), which is highly predictable. Minor deviations exist in noun-style or question-style names (time_snapshot, are_they_awake, answer_time_question), but they remain readable and unambiguous.
34 tools is heavy for a single server and pushes well past the comfortable 3-15 range, even given the genuinely broad scope (time intelligence, guest booking, host management, teams). Several clusters (teams CRUD, invite links, booking-page operations) could be consolidated or split into separate servers to keep the surface navigable.
Coverage is genuinely broad: full team CRUD (list/get/save/rename/delete), a complete booking lifecycle (find slots, request, approve, decline, cancel, reschedule, status), booking-page read/update, invite link create/revoke, and deep time-intelligence. Gaps are minor — e.g. no tool to delete a booking page or manage non-main meeting types individually — but agents can work around these.
Available Tools
34 toolsanswer_time_questionAnswer a time questionARead-onlyIdempotentInspect
Answers a time, time zone, or scheduling question written in plain language, including messy or mixed questions and relative dates such as "Tuesday", "next Friday", "tomorrow", or "in 3 weeks". Resolves the intent, locations, and date and returns a structured answer. Supported intents include current time, conversion, daylight saving changes, overlapping work hours, meeting times, abbreviations, and IANA time zones. Unknown or ambiguous locations return clarification candidates.
Inputs: query (required), now, date, locale, +2 more.
approve_booking_requestApprove a booking requestADestructiveIdempotentInspect
Approves a host's booking request. findtime.io adds it to the host's Google Calendar and Google sends the invite. Answers needs_calendar_connect when Calendar isn't connected, needs_payment when the account has no meeting allowance, needs_sync for an unfinished approval whose retry resumes the same event, or conflict when the request changed. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: requestId (required), lifecycleVersion (required), confirm, message, +2 more. Returns: hint, link, error, retry, +6 more
are_they_awakeCheck who is awakeARead-onlyIdempotentInspect
Reports whether people in other cities are within work, awake, or sleep hours at a specified moment. myTime defaults to now. myTimezone accepts an IANA zone; myCity supplies location context when myTimezone is omitted. The result includes formatted shareText and may include a plannerUrl with alternative aiSlots.
Inputs: date, myCity, myTime, teamId, +8 more.
cancel_bookingCancel my bookingADestructiveIdempotentInspect
Cancels the guest's request or approved meeting. findtime.io emails the host, and an approved meeting's calendar event is removed. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: requestId (required), reason, confirm, _endUserId, +2 more. Returns: hint, error, reason, status, +3 more
cancel_booking_as_hostCancel a booking as hostADestructiveIdempotentInspect
Cancels a request or approved meeting as the host. The status changes first, then the Google Calendar event is removed. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: requestId (required), lifecycleVersion (required), reason, confirm, +1 more. Returns: hint, link, error, retry, +6 more
check_proposed_timeCheck a proposed meeting timeARead-onlyIdempotentInspect
Evaluates a proposed meeting instant for each city. start accepts an ISO instant or a floating local time with home set to an IANA timezone. The result includes the UTC instant, local times, verdicts, formatted shareText, and up to three alternative aiSlots. A context field describes any skipped or repeated local time caused by daylight saving changes.
Inputs: start (required), date, home, teamId, +6 more.
convert_timeConvert a timeARead-onlyIdempotentInspect
Converts a source timezone local time into one or more target locations. Requires structured from, to, and time fields. Whole-sentence questions are not location values. Unknown or ambiguous cities return clarification candidates. date accepts ISO YYYY-MM-DD, and time may include a simple human date phrase such as "3pm Tuesday". The result includes authoritative localTime.weekday, localTime.date, localTime.time12h/time24h, timezone abbreviation, and UTC offset for each location.
Inputs: to (required), from (required), time (required), date, +3 more.
create_invite_linkCreate a personal invite linkAInspect
Creates a personal booking link for one guest, with their name and email locked on it. findtime.io returns the link without sending it to the guest. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: guestName (required), guestEmail (required), note, confirm, +4 more. Returns: url, hint, error, reason, +4 more
decline_booking_requestDecline a booking requestADestructiveIdempotentInspect
Declines a host booking request. The guest sees it as declined. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: requestId (required), lifecycleVersion (required), reason, confirm, +1 more. Returns: hint, link, error, retry, +6 more
delete_teamDelete a saved groupADestructiveIdempotentInspect
Deletes a homepage Saved group by its exact name. Without an account, returns teams_not_persisted.
Inputs: teamId (required), _endUserId.
find_host_slotsFind a host's open timesARead-onlyInspect
Lists a findtime.io host's open times as numbered options in the guest's and host's zones, with explicit dates and abbreviations across clock changes. Accepts structured handle, durationMinutes, askerZone, and ISO dates or date ranges; startUtc and endUtc specify an instant window, and exactStart checks one time. Relative date phrases are not supported. today contains the current date in askerZone. optionId values correspond to the numbered list and expire after about 15 minutes. A slot option is not a booking; every request requires host approval. Every result has a status. ok contains the answer. needs_clarification contains a question and candidate retry arguments. no_match reasons include host_not_found, host_busy_in_window with nearest alternatives, outside_booking_window, duration_not_offered, and host_not_taking_requests. temporarily_unavailable indicates a temporary service failure.
Inputs: handle (required), now, dates, hours, +15 more. Returns: days, hint, host, more, +18 more
find_meeting_timeFind a meeting timeBRead-onlyIdempotentInspect
Returns ranked meeting suggestions for structured locations and an optional date. date accepts ISO YYYY-MM-DD or a simple human day/date value such as "Thursday", "tomorrow", or "next Friday", resolved relative to the first location timezone. shareText contains formatted results. plannerUrl includes locations, up to three UTC aiSlots, legacy aiTime, and ref=mcp-bot.
Inputs: date, teamId, locations, _endUserId, +2 more.
get_booking_statusCheck a booking requestARead-onlyIdempotentInspect
Checks one booking request with status waiting for the host, approved (with the meeting link or place once the host approves), declined or cancelled, with explicit times in the guest's and host's zones. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: requestId (required), guestTrackingToken (required), _endUserId. Returns: hint, error, reason, status, +2 more
get_current_timeGet the current timeARead-onlyIdempotentInspect
Returns the current local time for one city, location query, or IANA time zone. Ambiguous or unknown locations return clarification candidates. Country-name queries may resolve through a canonical city. This endpoint accepts locations rather than relative-date questions and does not perform conversions or meeting searches.
Inputs: city, query, timezone, _endUserId, +3 more.
get_dst_scheduleGet a daylight saving scheduleBRead-onlyIdempotentInspect
Returns daylight saving schedules, current abbreviations, and transition details for a city or time zone. An explicit year selects transitions for that civil year; at sets the reference instant. This endpoint accepts structured location, year, and timestamp fields rather than relative-date questions.
Inputs: at, city, year, query, +3 more.
get_findtime_helpGet findtime.io helpARead-onlyIdempotentInspect
Returns findtime.io MCP usage help, supported time-intelligence intents, answer examples, and ambiguity examples. Local package results also include installation and deployment configuration.
Inputs: _endUserId.
get_host_booking_profileGet a host's booking profileARead-onlyIdempotentInspect
Reads a findtime.io host's booking profile for a guest, including name, time zone, meeting lengths, meeting types, minimum notice, and passcode requirement. handle accepts the exact host handle or booking-page link; first names alone are not searchable. The host sets the meeting location on approval and approves or declines every request. Every result has a status. ok contains the answer. needs_clarification contains a question and candidate retry arguments. no_match reasons include host_not_found, host_busy_in_window with nearest alternatives, outside_booking_window, duration_not_offered, and host_not_taking_requests. temporarily_unavailable indicates a temporary service failure.
Inputs: handle (required), _endUserId. Returns: hint, host, error, reason, +10 more
get_location_by_idGet a location by IDBRead-onlyIdempotentInspect
Returns an exact production location record for a stable findtime.io location identifier. The identifier refers to a record in the location catalog.
Inputs: id (required), _endUserId.
get_my_booking_pageGet my booking pageARead-onlyIdempotentInspect
Returns the host's own findtime.io booking page. Link, meeting lengths, weekly hours in their zone, paused or private, passcode on or off, the agent booking switch, free meetings used and left, and active personal invite links. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: _endUserId. Returns: hint, link, page, error, +5 more
get_overlap_hoursFind shared work hoursBRead-onlyIdempotentInspect
Returns shared business-hours overlap for structured locations and an optional date. date accepts ISO YYYY-MM-DD or a simple human day/date value such as "Thursday", "tomorrow", or "next Friday", resolved relative to the first location timezone.
Inputs: locations (required), date, _endUserId, countryCodes.
get_teamGet a saved groupARead-onlyIdempotentInspect
Loads one homepage Saved group by its exact, case-sensitive name. Without an account, returns teams_not_persisted.
Inputs: teamId, _endUserId.
list_booking_requestsList my incoming booking requestsARead-onlyIdempotentInspect
Lists the host's booking requests with guest name and email, explicit times in the host's zone, an agent-origin tag, status, lifecycleVersion, and permitted actions. olderRequests contains the count and inbox link for older requests available only on the website. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: to, from, status, _endUserId. Returns: hint, error, reason, status, +3 more
list_my_booking_requestsList my booking requestsARead-onlyIdempotentInspect
Lists every request this guest sent to one host, with status and explicit times. Requires the guestHistoryToken returned with the request. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: guestHistoryToken (required), _endUserId. Returns: hint, error, reason, status, +2 more
list_teamsList saved groupsARead-onlyIdempotentInspect
Lists homepage Saved groups for the signed-in Google account, including their exact names. Without an account, returns teams_not_persisted.
Inputs: _endUserId.
rank_recurring_slotRank a recurring meeting timeARead-onlyIdempotentInspect
Scores a weekly wall-clock meeting time across locations, including a daylight-saving week when one occurs in the next 26 weeks. weekday is a day name, time is a clock value such as 9am, and home is the IANA zone of that clock. Results include formatted shareText, a less disruptive alternative, a plannerUrl, and context for skipped or repeated local times.
Inputs: home (required), time (required), weekday (required), now, +8 more.
rename_teamRename a saved groupADestructiveInspect
Renames a homepage Saved group. teamId is the current exact name. nextName is the new name. Cities stay on the group. The new name must not already exist. Without an account, returns teams_not_persisted.
Inputs: teamId (required), nextName (required), _endUserId.
request_bookingRequest a bookingADestructiveInspect
Requests an available slot for the signed-in guest using an optionId from a recent availability response, guest name, and guest zone. The guest email comes from the authenticated identity; typed email is ignored. An idempotencyKey identifies this request and prevents duplicate sends when reused on retry. The host approves or declines; nothing is booked before approval. Successful results contain guestTrackingToken for this request. guestHistoryToken is a newly issued link to this guest's requests to the host, or null when no new link was issued. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Other statuses include no_match for option_expired or slot_taken, existing_request for an overlapping request, rate_limited, and needs_sign_in. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: handle (required), optionId (required), guestName (required), notes, +7 more. Returns: hint, error, reason, status, +9 more
reschedule_bookingReschedule my booking requestADestructiveInspect
Moves a pending request to another available option for the same host. Withdraws the old request and sends a new one. Approved meetings cannot be moved through this tool and return no_match with reason confirmed_needs_host. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: optionId (required), requestId (required), invite, confirm, +5 more. Returns: hint, error, reason, status, +7 more
revoke_invite_linkRevoke a personal invite linkADestructiveIdempotentInspect
Revokes one personal booking link belonging to the host. linkId identifies an existing link on the host's booking page. Revocation stops future use without cancelling existing requests. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: linkId (required), confirm, _endUserId. Returns: hint, error, reason, status, +3 more
save_teamSave a groupADestructiveInspect
Creates or replaces one homepage Saved group for the signed-in Google account. teamId is the exact group name. locations replaces the complete city list, with entries such as London|Europe/London. Names are case-sensitive. Without an account, returns teams_not_persisted.
Inputs: teamId, locations, _endUserId.
search_timezonesSearch places and time zonesARead-onlyIdempotentInspect
Searches and disambiguates cities, countries, abbreviations, and time zones. Results include location identifiers, suggestedQuery values, and country codes. Does not return the current time.
Inputs: query (required), limit, _endUserId, countryCode, +2 more.
send_feedbackReport a wrong answerAInspect
Sends findtime.io a report that one of its tool answers was wrong, incomplete, or unhelpful. Required: tool, query, and whatWasWrong. Optional: expectedAnswer. The query is used only to classify the report and is then discarded; findtime.io keeps the tool name, an error class, flags, and counts, not the query, the expected answer, or any other free text. The fields are not meant for names, emails, phone numbers, IP addresses, or user ids.
Inputs: tool (required), query (required), whatWasWrong (required), _endUserId, +1 more.
time_snapshotGet a time snapshotCRead-onlyIdempotentInspect
Returns the production time snapshot payload for one location or a list of locations.
Inputs: query, locations, _endUserId, countryCode, +2 more.
update_booking_pageUpdate my booking pageADestructiveIdempotentInspect
Updates the host's main meeting type lengths, weekly hours, page pause state, and agent booking setting. Hours are clock ranges in the host's zone; days left out keep their hours, and [] closes a day. Without confirm: true, the operation changes nothing and returns a read-back with status needs_confirmation. confirm: true executes the same operation after the person has confirmed that read-back. Every result has a status listed in the output schema. temporarily_unavailable indicates a temporary service failure.
Inputs: paused, confirm, durations, _endUserId, +3 more. Returns: hint, page, error, reason, +4 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
World clock, time conversions, DST dates and meeting times. Free, no login.
Current time, time differences, DST changes and time conversion for any city or IANA time zone.
Related MCP Servers
- AlicenseAqualityBmaintenanceFree, keyless MCP server for timezone conversion, world clock, DST-aware date arithmetic, and cross-timezone meeting scheduling using IANA timezones.9MIT
- AlicenseNot gradedqualityDmaintenanceA timezone-aware MCP server that converts times, looks up current local times, and finds overlapping working-hour slots for distributed teams.MIT

World Clock Pro MCPofficial
AlicenseNot gradedqualityDmaintenanceA read-only MCP server that gives AI agents accurate current time, timezone conversions, DST transitions, and city lookups using live IANA timezone data, with cited sources.MIT- AlicenseAqualityBmaintenanceMCP server for time, timezone, and duration operations. Enables getting current time in any timezone, converting timestamps between timezones, adding/subtracting ISO-8601 durations, and computing time between two timestamps.5260 npm1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.