World Time MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@World Time MCP Server What time is it right now in Tokyo and London?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
World Time MCP server
An MCP server that tells the current time in cities around the world and converts times between cities.
It works fully offline: city names are resolved to IANA time zones using the bundled
GeoNames dataset (~34,000 cities with population > 15,000, via
geonamescache), and times are computed locally with Python's zoneinfo (DST included).
No API keys, no rate limits, no external service to go down.
Tools
Tool | Arguments | Description |
|
| Current local time in a city or IANA zone |
|
| Current time in several cities at once |
|
| Convert a time from one city to another |
|
| List matching cities and their zones (for ambiguous names) |
City inputs accept:
Plain names, case- and accent-insensitive:
Colombo,sao paulo,BombayA country or US state qualifier:
London, Canada,Paris, TX,Portland, OregonIANA time zones:
Asia/Tokyo,UTC
Ambiguous names resolve to the most populous match (Paris → Paris, France).
time accepts 14:30, 2:30 PM, or a dated value such as 2026-03-29 14:30 / 2026-03-29 2:30 PM.
Time-only values are taken as today in from_city.
Example get_time("Colombo") result:
{
"query": "Colombo",
"city": "Colombo, Sri Lanka",
"timezone": "Asia/Colombo",
"local_time": "2026-11-16T08:36:42+05:30",
"readable": "Monday, 16 November 2026, 08:36",
"utc_offset": "+05:30",
"abbreviation": "+0530",
"is_dst": false
}Related MCP server: Timezone MCP Server
Install
Requires Python 3.10+.
git clone https://github.com/raditha-codev/mcp-demo.git
cd mcp-demo
python -m venv .venv && source .venv/bin/activate
pip install -e .Or run it straight from GitHub with uv:
uvx --from git+https://github.com/raditha-codev/mcp-demo world-time-mcpUse with an MCP client
The server speaks MCP over stdio. Add it to your client's config, e.g. Claude Desktop
(claude_desktop_config.json), Cursor (.cursor/mcp.json) or Windsurf:
{
"mcpServers": {
"world-time": {
"command": "uvx",
"args": ["--from", "git+https://github.com/raditha-codev/mcp-demo", "world-time-mcp"]
}
}
}If you installed it locally instead, point command at the virtualenv's executable,
e.g. "/path/to/mcp-demo/.venv/bin/world-time-mcp" with no args.
To try it interactively, use the MCP Inspector:
npx @modelcontextprotocol/inspector .venv/bin/world-time-mcpDevelopment
pip install -e ".[dev]"
pytest
ruff check . && ruff format --check .Available Tools
4 toolscompare_timesARead-only
Get the current local time in several cities at once.
Args: cities: City names or IANA zones, e.g. ["Colombo", "London", "New York"].
Inputs: cities (required). Returns: result
convert_timeARead-only
Convert a time in one city to the local time in another city.
Args:
time: Time in the source city: "14:30", "2:30 PM", or "2026-03-29 14:30" /
"2026-03-29 2:30 PM" for a specific date. Time-only values are taken as today in from_city.
from_city: City (or IANA zone) the time belongs to.
to_city: City (or IANA zone) to convert the time to.
Inputs: time (required), to_city (required), from_city (required). Returns: object
find_citiesARead-only
List cities matching a name, largest first, with their time zones.
Useful when a name is ambiguous (e.g. "Paris" or "Springfield").
Args: query: City name, optionally with a country or US state after a comma. limit: Maximum number of results (1-25).
Inputs: query (required), limit. Returns: result
get_timeARead-only
Get the current local time in a city (or IANA time zone).
Args: city: City name, optionally with a country or US state, e.g. "Colombo", "London, Canada", "Portland, OR", or an IANA zone like "Asia/Tokyo".
Inputs: city (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a reasonably distinct purpose: get_time for one city's current time, convert_time for translating a specific time between cities, compare_times for a multi-city snapshot, and find_cities for resolving ambiguous names. The only mild overlap is get_time vs. compare_times, since the latter is effectively a batch version of the former, but the singular/plural distinction is easy to infer.
All four tools follow a consistent verb_noun snake_case pattern: get_time, convert_time, compare_times, find_cities. No mixed conventions or vague verbs.
Four tools is a tight, well-scoped surface for a world-time server, and each one earns its place (lookup, single-city time, conversion, multi-city comparison). Nothing appears redundant or missing from a count perspective.
The surface covers the core lifecycle: resolve a city, get current time, convert a time, and compare multiple cities. Minor gaps exist, such as computing elapsed duration or difference between two arbitrary times, but agents can approximate these with convert_time.
Maintenance
Related MCP Connectors
Current time, time differences, DST changes and time conversion for any city or IANA time zone.
Get the current time anywhere and access concise timezone information. Set your preferred timezone…
Get the current time in any timezone and quickly look up common timezone info. Set a default timez…
Get the current time in any timezone. Explore concise timezone info to pick the right region. Simp…
Related MCP Servers
- AlicenseAqualityDmaintenanceAccess the time in any timezone and get the current local time142MIT
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to get current time information for any timezone worldwide, including available regions, cities, and ISO 8601 formatted timestamps with timezone offsets.8-
- AlicenseBqualityDmaintenanceProvides current time and timezone conversion using IANA timezone names, enabling LLMs to get time information and convert times between timezones.2MIT
- AlicenseAqualityCmaintenanceProvides current local time and time in any IANA timezone, along with timezone listing and NTP-based time retrieval with clock offset information.4MIT