findtime.io MCP Server
A clean stdio wrapper around the production findtime.io Time API that keeps time zone logic, DST transitions, and meeting scheduling aligned with the live service instead of reimplementing it locally. Exposes ten tools including answer_time_question for messy natural language prompts like "3pm PST to London" or "working hours overlap for SF, Berlin, Tokyo", plus deterministic operations for current time, DST schedules, conversions, overlap calculations, and meeting searches across cities. Requires a findtime.io developer API key and Node 20+. Built for multi-user environments with optional per-call end user attribution via an _endUserId argument that gets forwarded upstream without logging PII. Useful when you need reliable time operations that stay in sync with a maintained service rather than chasing edge cases in local implementations.
- tools
- 35
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 3
- last updated
- Nov 2, 2026
Tools
35 toolsPublic tool metadata for what this MCP can expose to an agent.
answer_time_questionPrefer for messy natural-language prompts such as "3pm PST to London", "what is the IANA timezone for San Francisco?", "working hours overlap for SF, Berlin, and Tokyo", or "what does CST mean?".
Prefer for messy natural-language prompts such as "3pm PST to London", "what is the IANA timezone for San Francisco?", "working hours overlap for SF, Berlin, and Tokyo", or "what does CST mean?".
No parameter schema in public metadata yet.
get_findtime_help
No parameter schema in public metadata yet.
get_api_diagnostics
No parameter schema in public metadata yet.
send_feedbackReports a wrong answer; sends the tool name, never the query text.
Reports a wrong answer; sends the tool name, never the query text.
No parameter schema in public metadata yet.
time_snapshot
No parameter schema in public metadata yet.
get_current_time
No parameter schema in public metadata yet.
get_dst_schedule
No parameter schema in public metadata yet.
convert_time
No parameter schema in public metadata yet.
get_overlap_hours
No parameter schema in public metadata yet.
find_meeting_time
No parameter schema in public metadata yet.
check_proposed_timeVerdicts for a time the user already picked (/meeting/check).
Verdicts for a time the user already picked (/meeting/check).
No parameter schema in public metadata yet.
are_they_awakeWork, awake, or sleep in other cities at one moment (/meeting/awake).
Work, awake, or sleep in other cities at one moment (/meeting/awake).
No parameter schema in public metadata yet.
rank_recurring_slotWho a weekly time punishes, plus a kinder slot (/meeting/recurring).
Who a weekly time punishes, plus a kinder slot (/meeting/recurring).
No parameter schema in public metadata yet.
search_timezones
No parameter schema in public metadata yet.
get_location_by_id
No parameter schema in public metadata yet.
save_teamHosted server only: reads and writes Saved groups of the signed-in Google account.
Hosted server only: reads and writes Saved groups of the signed-in Google account.
No parameter schema in public metadata yet.
get_teamHosted server only: reads Saved groups of the signed-in Google account.
Hosted server only: reads Saved groups of the signed-in Google account.
No parameter schema in public metadata yet.
list_teamsHosted server only: lists Saved groups of the signed-in Google account.
Hosted server only: lists Saved groups of the signed-in Google account.
No parameter schema in public metadata yet.
rename_teamHosted server only: renames a Saved group of the signed-in Google account.
Hosted server only: renames a Saved group of the signed-in Google account.
No parameter schema in public metadata yet.
delete_teamHosted server only: deletes a Saved group of the signed-in Google account.
Hosted server only: deletes a Saved group of the signed-in Google account.
No parameter schema in public metadata yet.
get_host_booking_profileHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
find_host_slotsHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
request_bookingHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
get_booking_statusHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
list_my_booking_requestsHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
cancel_bookingHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
reschedule_bookingHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
get_my_booking_pageHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
list_booking_requestsHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
approve_booking_requestHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
decline_booking_requestHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
cancel_booking_as_hostHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
update_booking_pageHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
create_invite_linkHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
revoke_invite_linkHosted server only: booking tool.
Hosted server only: booking tool.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
FINDTIME_TIME_API_KEY*secretfindtime.io developer API key used to authenticate requests to the Time API.
FINDTIME_TIME_API_BASE_URLOptional override for the Time API base URL. Defaults to https://time-api.findtime.io.
FINDTIME_MCP_CLIENT_TYPEOptional client hint for transport behavior, such as cursor or codex.
Readme
@findtime/mcp-server
@findtime/mcp-server is a thin stdio MCP wrapper over the production findtime.io Time API at https://time-api.findtime.io.
The package intentionally proxies the production API instead of re-implementing time logic locally. Current time, DST, conversion, overlap, meeting search, and location resolution should stay aligned with the live API.
Published surfaces:
Details
- Repository
- github.com/hkchao/findtime-mcp-server
- Website
- findtime.io
- Package
@findtime/mcp-server- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active