Skip to main content
Glama

Server Details

MCP server for time in cities around the world, time zones, DST, conversion, and meetings.

Ownership verified
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

B3.3/5.0

Scored across 34 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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 tools
answer_time_questionAnswer a time questionA
Read-onlyIdempotent
Inspect

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 requestA
DestructiveIdempotent
Inspect

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 awakeA
Read-onlyIdempotent
Inspect

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 bookingA
DestructiveIdempotent
Inspect

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 hostA
DestructiveIdempotent
Inspect

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 timeA
Read-onlyIdempotent
Inspect

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 timeA
Read-onlyIdempotent
Inspect

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.

decline_booking_requestDecline a booking requestA
DestructiveIdempotent
Inspect

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 groupA
DestructiveIdempotent
Inspect

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 timesA
Read-only
Inspect

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 timeB
Read-onlyIdempotent
Inspect

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 requestA
Read-onlyIdempotent
Inspect

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 timeA
Read-onlyIdempotent
Inspect

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 scheduleB
Read-onlyIdempotent
Inspect

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 helpA
Read-onlyIdempotent
Inspect

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 profileA
Read-onlyIdempotent
Inspect

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 IDB
Read-onlyIdempotent
Inspect

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 pageA
Read-onlyIdempotent
Inspect

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 hoursB
Read-onlyIdempotent
Inspect

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 groupA
Read-onlyIdempotent
Inspect

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 requestsA
Read-onlyIdempotent
Inspect

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 requestsA
Read-onlyIdempotent
Inspect

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 groupsA
Read-onlyIdempotent
Inspect

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 timeA
Read-onlyIdempotent
Inspect

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 groupA
Destructive
Inspect

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 bookingA
Destructive
Inspect

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 requestA
Destructive
Inspect

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

save_teamSave a groupA
Destructive
Inspect

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 zonesA
Read-onlyIdempotent
Inspect

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 snapshotC
Read-onlyIdempotent
Inspect

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 pageA
DestructiveIdempotent
Inspect

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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A timezone-aware MCP server that converts times, looks up current local times, and finds overlapping working-hour slots for distributed teams.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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
    • A
      license
      A
      quality
      B
      maintenance
      MCP 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.
      5
      260 npm
      1
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.