WhatTimeIsIt

A lightweight mcp server that tells you exactly what time is it based on your IP.

python

8

GitHub Stars

python

Language

6 months ago

First Indexed

2 months 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": {
    "kukapay-whattimeisit-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/whattimeisit-mcp",
        "run",
        "main.py"
      ]
    }
  }
}

WhatTimeIsIt MCP Server is a lightweight Python-based MCP server that returns the current time as an ISO 8601 string. It leverages World Time to provide accurate time information based on your location, making it easy to embed reliable time data into your workflows or applications.

How to use

You run WhatTimeIsIt through an MCP client and call the single tool it exposes. The tool returns the current time as an ISO 8601 string, suitable for logging, scheduling, or timestamping events. To use it, start the MCP server via your MCP runtime and invoke the tool named what_time_is_it from your client. The server will respond with a string like 2025-03-17T03:17:00+11:00.

How to install

Prerequisites you need on your system before installing this MCP server: Node.js is not required for runtime, but you will use a client installer and the provided runtime command. Ensure you have a shell environment with Git installed for cloning and updating the repository. You will also need an MCP client capable of running stdio MCP servers.

Install the MCP server auto-installer via Smithery to set up the client integration, then configure the local MCP server for manual use.

npx -y @smithery/cli install @kukapay/whattimeisit-mcp --client claude

If you prefer manual installation, follow these steps to clone the project and configure the client to start the MCP server locally.

# Step 1: Clone the repository
git clone https://github.com/kukapay/whattimeisit-mcp.git

# Step 2: Client configuration
# Create or update your MCP client configuration with the following snippet
{
  "mcpServers": {
    "whattimeisit": {
      "command": "uv",
      "args": ["--directory", "path/to/whattimeisit-mcp", "run", "main.py"]
    }
  }
}

Additional content

Tools exposed by this MCP server include a single operation named what_time_is_it. This tool returns the current time as a string in ISO 8601 format and is designed to be used wherever you need an accurate timestamp based on your location.

Available tools

what_time_is_it

Returns the current time string in ISO 8601 format based on the client's IP, suitable for timestamping and time-aware workflows.