home / mcp / time mcp server

Time MCP Server

MCP server - make Claude tell the time! Highly reliable and consistent.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "samay58-time-mcp": {
      "command": "python",
      "args": [
        "-m",
        "src.time_mcp.server"
      ]
    }
  }
}

You can run a dedicated MCP server that serves real-time, timezone-aware date and time information for Claude AI. It uses Python’s zoneinfo to provide accurate timestamps across IANA time zones and returns results in ISO format for easy consumption by clients.

How to use

Run the MCP server locally and connect your Claude AI client to it to request the current time in any IANA timezone. Use the available tool to get get_current_time by providing a timezone parameter when needed. If you omit the parameter, the server defaults to UTC. The tool responds with the current time in ISO format, suitable for downstream processing or display.

How to install

Prerequisites: Python 3.10 or newer, and basic command-line tooling.

Step 1: Clone the project repository.

Step 2: Change into the project directory.

Step 3: Set up a Python virtual environment and activate it.

Step 4: Install the package in editable mode.

Additional content

The server exposes a single MCP tool named get_current_time. It accepts one parameter: timezone, a string representing any valid IANA timezone (for example, America/New_York, Europe/London, or Asia/Tokyo). If you do not provide a value, the server uses UTC as the default.

Development notes: You can run tests if you have the test suite available, and you can lint and format the code to maintain quality during development.

Available tools

get_current_time

Returns the current time in the specified timezone. Parameter: timezone (string) — Any valid IANA timezone (e.g., "America/New_York", "Europe/London", "Asia/Tokyo"). Default: UTC if no timezone is specified.