# findtime.io MCP Server

> findtime.io MCP Server is a freemium MCP server for productivity. Time zone, DST, conversion and meeting-overlap lookups for AI assistants. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API, Web
- **Website:** https://findtime.io
- **Repository:** https://github.com/hkchao/findtime-mcp-server
- **MCP Registry name:** io.github.hkchao/findtime-mcp-server
- **Categories:** productivity, communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.findtime.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "findtime-mcp-server": {
      "url": "https://mcp.findtime.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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).

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/findtime-io-mcp-server
