Skip to content
MCP server

findtime.io MCP Server

Time zone, DST, conversion and meeting-overlap lookups for AI assistants

Install
Pricing
Freemium
Platforms
CLI, API, Web
Runs
Locally or Remotely
Version
3.28.1
Listing updated
3 days ago

About findtime.io MCP Server

findtime.io MCP Server is a freemium MCP server for productivity. It can run locally on your machine or as a hosted remote server.

The server wraps the findtime.io Time API instead of reimplementing time logic, so answers for current time, daylight saving schedules, conversions and overlaps match what the live service returns. There are two ways in: an npm stdio package that needs a FINDTIME_TIME_API_KEY, and a hosted Streamable HTTP endpoint with OAuth sign-in.

Both cover the time and meeting-planning tools, including a check on a time you already picked and a check on whether people in other cities would be awake. The hosted server adds saved teams, and, after signing in with Google and granting the booking scopes, tools to request, reschedule and cancel bookings or to manage a booking page as a host. An API key never gets the booking tools.

The hosted server lists only the time:read and meetings:plan scopes by default. The booking scopes are left out of the advertised list on purpose and are granted only when a client asks for them by name.

Install

Run in a terminal

claude mcp add --transport http findtime-mcp-server https://mcp.findtime.io/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.findtime.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "findtime-mcp-server": {
      "url": "https://mcp.findtime.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "findtime-mcp-server": {
      "type": "http",
      "url": "https://mcp.findtime.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "findtime-mcp-server": {
      "serverUrl": "https://mcp.findtime.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "findtime-mcp-server": {
      "type": "http",
      "url": "https://mcp.findtime.io/mcp"
    }
  }
}

Configuration

  • FINDTIME_TIME_API_KEYfindtime.io developer API key used to authenticate requests to the Time API.Required
  • 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.

Tools this server provides (15)

Taken from the project documentation; the running server may differ.

answer_time_question
Answer a time question.
get_findtime_help
Return help on using findtime.
get_api_diagnostics
Return diagnostics for the Time API.
send_feedback
Report a wrong answer; sends the tool name, never the query text.
time_snapshot
Take a time snapshot.
get_current_time
Get the current time in a city.
get_dst_schedule
Get the daylight saving schedule.
convert_time
Convert a time between zones.
get_overlap_hours
Find overlapping working hours.
find_meeting_time
Find a meeting time across zones.
check_proposed_time
Give verdicts for a time the user already picked.
are_they_awake
Say whether people in other cities are at work, awake or asleep.
rank_recurring_slot
Rank a recurring slot.
save_team
Save a team of cities (hosted server).
request_booking
Request a booking with a host (hosted server).

What it does

Time and DST lookups
Get the current time and daylight saving schedule for cities.
Meeting time search
Find meeting times and overlap hours across several time zones.
Proposed-time checks
Check a chosen time and see whether others would be at work, awake or asleep.
Saved teams
The hosted server stores named groups of cities for recurring meetings.
Booking tools
Signed-in users can request, approve and cancel bookings through scoped OAuth.
Stdio or hosted
Use the npm package with an API key or the hosted HTTP endpoint.

Good for

  • Convert a meeting time for a distributed team
  • Find hours when people in several cities are all at work
  • Check whether a proposed call falls in someone's sleeping hours
  • Look up when daylight saving changes in a city
  • Let an assistant request or approve a booking on a findtime booking page

Pricing

Freemium

API key required for the npm package; its price is not published. Booking link: first three accepted bookings free, then a one-time purchase.

Prices change. Check findtime.io before you buy.

findtime.io MCP Server FAQ

What does the npm package need?

A findtime.io developer API key, set as `FINDTIME_TIME_API_KEY`.

Where is the hosted server?

At https://mcp.findtime.io/mcp, over Streamable HTTP with OAuth sign-in.

Can an API key use the booking tools?

No. Booking tools need a findtime account signed in with Google on the hosted server.

Which scopes are granted by default?

time:read and meetings:plan. booking:request and booking:host must be asked for by name.

Is findtime.io MCP Server free?

findtime.io MCP Server has a free plan, with paid plans for more usage or features.

How do I add findtime.io MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http findtime-mcp-server https://mcp.findtime.io/mcp

What are the best alternatives to findtime.io MCP Server?

The closest alternatives to findtime.io MCP Server are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to findtime.io MCP Server

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media