Simple Timeserver
About
Provides current local time, UTC time, and timezone information.
Details
- Author
- andybrandt
- Repository
- andybrandt/mcp-simple-timeserver
- GitHub stars
- 10
- Downloads
- 9,459
- License
- MIT License
- Categories
- Other, Productivity, Design, Developer Tools, AI, Infrastructure, Project Management, Frontend
- Tags
- #mobile
Jump to
- Returns local time from user’s machine.
- Accurate UTC via NTP time servers.
- Converts time across locations and timezones.
- Calculates durations and business days between dates.
- Fetches public and school holidays for 119 countries.
- Supports multiple calendar formats (Hijri, Japanese, Hebrew, Persian).
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Simple TimeserverCommand (node, npx, python, etc.)pythonArguments-
Argument 1
-m -
Argument 2
mcp_simple_timeserver
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the package with pip install mcp-simple-timeserver, then configure it in your MCP client (e.g., Claude Desktop) by adding a JSON entry with "command": "python" and "args": ["-m", "mcp_simple_timeserver"]. Alternatively, install automatically via Smithery: npx -y @smithery/cli install mcp-simple-timeserver --client claude.
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.
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"simple timeserver": {
"cwd": "",
"env": {},
"args": [
"-m",
"mcp_simple_timeserver"
],
"shell": false,
"command": "python"
}
}
}Linux
{
"cwd": "",
"env": [],
"args": [
"-m",
"mcp_simple_timeserver"
],
"shell": false,
"command": "python"
}Macos
{
"cwd": "",
"env": [],
"args": [
"-m",
"mcp_simple_timeserver"
],
"shell": false,
"command": "python"
}Windows
{
"cwd": "",
"env": [],
"args": [
"-m",
"mcp_simple_timeserver"
],
"shell": false,
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"
}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-timeserveris a simple MCP server that fixes that.
This server provides the following tools:
All tools (exceptget_local_time) use accurate time from NTP servers. If NTP is unavailable, they gracefully fall back to local server time with a notice.
Theget_current_timetool supports location parameters to get local time anywhere in the world:
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.
Theget_current_timetool also accepts an optionalcalendarparameter with a comma-separated list of calendar formats:
Example:get_current_time(city="Tokyo", calendar="japanese")returns Tokyo local time with Japanese Era calendar.
Time Distance Calculation viacalculate_time_distance
Calculate duration between two dates or times:
Location parameters (city,country,timezone) can also be used to specify timezone context.
Whenbusiness_days=true, time-of-day is ignored and dates are counted as full days (inclusive endpoints). Theunitparameter is ignored in this mode. Holidays are excluded only when they fall on weekdays.
Example:calculate_time_distance(from_date="now", to_date="2025-12-31")returns a countdown to New Year's Eve. Example:calculate_time_distance(from_date="2026-01-26", to_date="2026-01-30", business_days=true, exclude_holidays=true, city="Sydney")returns the number of business days in that range.
Holiday Information viaget_holidaysandis_holiday
Get public and school holiday information for ~119 countries:
Regional School Holidays: When using thecityparameter withis_holiday, school holidays are filtered to show only those affecting the specific region. This is particularly useful in countries where school holidays vary by region (e.g., Polish voivodeships, German Bundesländer, Spanish autonomous communities).
Example:is_holiday(city="Warsaw", date="2026-01-19")returns school holiday information specific to the Mazowieckie voivodeship.
- Public holidays:Nager.Date API(119 countries)
- School holidays:OpenHolidaysAPI(36 countries, mostly European)
To install Simple Timeserver for Claude Desktop automatically viaSmithery:
npx -y @smithery/cli install mcp-simple-timeserver --client claude
Then configure in MCP client - theClaude desktop app.
"mcpServers": { "simple-timeserver": { "command": "python", "args": ["-m", "mcp_simple_timeserver"] } }
Under Windows you have to check the path to your Python executable usingwhere pythonin thecmd(Windows command line).
Typical configuration would look like this:
"mcpServers": { "simple-timeserver": { "command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe", "args": ["-m", "mcp_simple_timeserver"] } }
This project also includes a network-hostable version that can be deployed as a standalone web server. For instructions on how to run and deploy it, please see theWeb Server Deployment Guide.
Or you can simply use my server by adding it underhttps://mcp.andybrandt.net/timeserverto Claude and other tools that support MCP.
Google Sheets - [BlackHawkMCP](https://g📇 ☁️ - MCP server connecting AI to Google Sheets. Read, write, and manage spreadsheets via natural language.
Real-time pricing, ratings, and feature comparisons for 508+ SaaS, AI, and security products across 45 categories. Zero dependencies, no auth required.
A calculator server that performs basic math operations like addition, subtraction, multiplication, division, power, and square root.
A simple server that provides the current UTC time.
Get the current time and perform timezone conversions using IANA timezone names.
Provides time-related functions such as current time queries, timezone conversions, and time difference calculations.
An MCP server that exposes datetime information to agentic systems and chat REPLs.
Automated document processing and extraction
Great Question is an Agentic UX research platform for product builders. Its MCP lets AI agents create studies directly from any AI tool, surface insights, find the right research candidates, and query your entire research repository.
Create and edit Tally forms and analyze submissions
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
