andybrandt/mcp-simple-timeserver

*One of the strange design decisions Anthropic made was depriving Claude of timestamps for messages sent by the user in claude.ai or current time in general. Poor Claude can't tell what time it is! mcp-simple-timeserver is a simple MCP server that fixes that.*
Available Tools
This server provides the following tools:
| Tool | Description |
|------|-------------|
| 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 |
All tools (except get_local_time) use accurate time from NTP servers. If NTP is unavailable, they gracefully fall back to local server time with a notice.
Location Support via get_current_time
The get_current_time tool supports location parameters to get local time anywhere in the world:
| Parameter | Description | Example |
|-----------|-------------|---------|
| city | City name (primary use case) | "Warsaw", "Tokyo", "New York" |
| country | Country name or ISO code | "Poland", "JP", "United States" |
| timezone | IANA timezone or UTC offset | "Europe/Warsaw", "+05:30" |
Priority: timezone > city > country. When location is provided, the response includes local time, timezone info, UTC offset, and DST status.
If today is a public holiday at the specified location, it will be shown in the output.
Calendar Support via get_current_time
The get_current_time tool also accepts an optional calendar parameter with a comma-separated list of calendar formats:
| Calendar | Description |
|----------|-------------|
| unix | Unix timestamp (seconds since 1970-01-01) |
| isodate | ISO 8601 week date (e.g., 2026-W03-6) |
| hijri | Islamic/Hijri lunar calendar |
| japanese | Japanese Era calendar (returns both English and Kanji) |
| hebrew | Hebrew/Jewish calendar (returns both English and Hebrew, includes holidays) |
| persian | Persian/Jalali calendar (returns both English and Farsi) |
Example: get_current_time(city="Tokyo", calendar="japanese") returns Tokyo local time with Japanese Era calendar.
Time Distance Calculation via calculate_time_distance
Calculate duration between two dates or times:
| Parameter | Description | Example |
|-----------|-------------|---------|
| from_date | Start date (ISO 8601 or "now") | "2025-01-15", "now" |
| to_date | End date (ISO 8601 or "now") | "2025-12-31", "2025-06-01T17:00:00" |
| unit | Output format | "auto", "days", "weeks", "hours", "minutes", "seconds" |
| business_days | Count only Mon-Fri (date-based, inclusive) | true |
| exclude_holidays | Also exclude public holidays (requires country/city) | true |
Location parameters (city, country, timezone) can also be used to specify timezone context.
When business_days=true, time-of-day is ignored and dates are counted as full days (inclusive endpoints).