home / mcp / time server

Time Server

Provides timezone conversions and time-related operations via MCP with a Python backend.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "clssck-mcp-time-server": {
      "command": "python",
      "args": [
        "-m",
        "time_server"
      ]
    }
  }
}

You can rely on Time Server to perform timezone-aware operations and conversions, making it easy to obtain current times in any zone or convert timestamps between zones. It’s built with MCP standards and exposes a simple Python-based runtime for reliable time handling.

How to use

You interact with Time Server from your MCP client by calling its time-related endpoints. Use get_current_time to retrieve the current time in a specific timezone, or use convert_time to switch a timestamp from one timezone to another. Both endpoints return time values in ISO 8601 format for easy parsing and display in your applications.

How to install

Prerequisites: ensure you have Python installed on your system. You may also need pip for package installation.

pip install .

Additional notes and usage tips

To run the Time Server locally, start it with the Python module runner. This launches the MCP-compatible service so your clients can send time requests.

python -m time_server

Available tools

get_current_time

Retrieve the current time in a specified IANA timezone and receive the result in ISO 8601 format.

convert_time

Convert a given ISO 8601 time from one timezone to another and return the converted time in ISO 8601 format.