home / mcp / mcp simple timeserver

MCP Simple Timeserver

Simple MCP to give Claude ability to check current time as well as know when holidays are, what is the time distance between dates etc.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "andybrandt-mcp-simple-timeserver": {
      "url": "https://mcp.andybrandt.net/timeserver"
    }
  }
}

MCP Simple Timeserver provides accurate local and global time information through a small MCP server, enabling clients to request current time, time distances, holidays, and calendar conversions. It helps ensure applications and assistants have reliable timestamps, which can be essential for scheduling, logging, and time-sensitive workflows.

How to use

You connect to the timeserver using an MCP client by adding the server configuration to your MCP settings. The server exposes several time-related capabilities: obtaining local and UTC times, computing durations between two dates, and retrieving public and school holidays for a location. When you configure an MCP client, you typically add an entry that points to either the local, runtime process or a remote HTTP endpoint. Once connected, you can request time data, perform calendar conversions, and calculate time distances directly from your MCP-enabled tools.

How to install

Prerequisites: ensure you have Python installed if you plan to run the local stdio MCP server. You may also opt to use the Smithery installation flow for automated setup.

Additional configuration and usage notes

The Timeserver can be run locally as an MCP stdio server or accessed remotely via an MCP HTTP endpoint. The local runtime usage shown in examples uses Python to launch the module that provides MCP functionality.

Troubleshooting and tips

If a time source is unavailable, time tools gracefully fall back to the local server time with a notice. For time-sensitive operations, prefer UTC time from NTP where available. When using location and calendar features, provide city, country, or timezone parameters to get accurate local times and calendar results.

Available tools

get_local_time

Returns the current local time, day of week, and timezone from the user’s machine.

get_utc

Returns accurate UTC time from an NTP time server.

get_current_time

Returns current time with optional location, timezone, and calendar conversions.

calculate_time_distance

Calculates duration between two dates/times (countdowns, elapsed time).

get_holidays

Returns public holidays (and optionally school holidays) for a country.

is_holiday

Checks if a specific date is a holiday in a given country or city.