MCP Catalogs
Home

mcp-simple-timeserver

by andybrandt·30·Score 44

A Python MCP server providing time queries, holiday information, and time calculations for Claude.

productivityai-llmother
16
Forks
3
Open issues
3 mo ago
Last commit
2d ago
Indexed

Overview

The mcp-simple-timeserver is a well-designed MCP server that addresses Claude's lack of timestamp functionality. It provides multiple tools for time-related operations, including getting local time, UTC time from NTP servers, calculating time distances between dates, and checking holidays worldwide. The server supports multiple locations, timezones, and calendar systems including Japanese, Hebrew, Hijri, and Persian calendars. The documentation is comprehensive with clear examples and configuration instructions for both manual and Smithery installations.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Adding time awareness to AI assistants that lack built-in time functionality
you:Calculating time differences between dates for scheduling and planning tasks
you:Checking public holidays in different countries for international business planning
you:Does this work with other AI assistants besides Claude?
you:How accurate is the time information provided?

When to choose this

Choose this server when your application needs accurate time data, date calculations, and holiday information across multiple countries and calendar systems.

When NOT to choose this

Avoid if you need highly customizable time formatting beyond what's provided, or if you need historical time data before 1970 (Unix epoch limitation).

Tools this server exposes

6 tools extracted from the README
  • 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

Comparable tools

mcp-date-utilsdate-fns-mcpmoment-mcp

Installation

Installation

Via Smithery

npx -y @smithery/cli install mcp-simple-timeserver --client claude

Manual Installation

pip install mcp-simple-timeserver
Claude Desktop Configuration

Mac OS:

"mcpServers": {
  "simple-timeserver": {
    "command": "python",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

Windows:

"mcpServers": {
  "simple-timeserver": {
    "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
    "args": ["-m", "mcp_simple_timeserver"]
  }
}

FAQ

Does this work with other AI assistants besides Claude?
Yes, this is a standard MCP server that should work with any MCP-compatible client.
How accurate is the time information provided?
All tools except get_local_time use accurate time from NTP servers. If NTP is unavailable, they fall back to local server time with a notice.

Compare mcp-simple-timeserver with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.