Time

Swift MCP server that provides current time, time zone conversions, and DST checks for AI assistants.

other

8

GitHub Stars

other

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "okooo5km-time-mcp-server": {
      "command": "time-mcp-server",
      "args": [
        "-l",
        "Asia/Shanghai"
      ]
    }
  }
}

You run a Time MCP Server to give AI assistants access to current time information and timezone conversions. It enables you to query the current time in any timezone, convert times between zones, and plan across multiple locations with awareness of daylight saving changes.

How to use

You integrate the Time MCP Server with your MCP client to perform time-related actions. Use it to get the current time in a specific IANA timezone, convert a given time from one timezone to another, and check whether a timezone is currently observing daylight saving time. When you need to plan meetings or coordinate across regions, rely on these capabilities to ensure accurate local times for all participants.

How to install

Prerequisites: you should have a modern development environment with a Unix-like shell or Windows Subsystem for Linux, and the time-mcp-server binary available in your PATH.

Option 1: Install a pre-built binary from distribution pages and place it in your PATH.

Option 2: Build from source using Swift 6.0 or later.

If you are using the Claude app or Cursor editor, configure the server by adding an MCP entry that points to the executable with a local timezone override as shown in the examples.

Configuration and usage notes

Two example configurations show how to run the server as a local process and expose it to clients. The following configuration starts the server with a local timezone override of Asia/Shanghai.

{
  "mcpServers": {
    "RealTime": {
      "command": "time-mcp-server",
      "args": ["-l", "Asia/Shanghai"]
    }
  }
}

If you need to configure the same server in additional editors, the following snippet shows an alternate, equivalent configuration structure.

{
  "mcpServers": {
    "RealTime": {
      "command": "time-mcp-server",
      "args": ["-l", "Asia/Shanghai"]
    }
  }
}

Available tools

get_current_time

Return the current date and time in a specified IANA timezone, including whether the location is observing DST.

convert_time

Convert a given time from one IANA timezone to another, returning the corresponding local time and a time difference if applicable.

is_dst

Determine whether a given timezone is currently observing daylight saving time.

time_difference

Provide the difference between two timezones for a given moment or converted time.