mcpField
T
timezone-mcp

timezone-mcp

Local
github.com/MukundaKattaProductivity0Updated 20w ago
Repository

About timezone-mcp

timezone-mcp is an MCP server for converting times using IANA timezone rules. It is intended for applications and assistants that need local times and offsets that account for daylight saving changes.

Key features

  1. 01Convert UTC instants to local time
  2. 02Get the current time in a timezone
  3. 03Look up DST-aware UTC offsets

Use cases

  1. 01Convert an event time for another timezone
  2. 02Check the offset at a specific instant

MCP support

Exposes timezone conversion, current-time, and offset tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "mukundakatta-timezone": {
      "command": "npx",
      "args": [
        "-y",
        "@mukundakatta/timezone-mcp"
      ]
    }
  }
}
Run commandnpx -y @mukundakatta/timezone-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@mukundakatta/timezone-mcp0.1.0

Tools

3

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
instantstringYesISO 8601 UTC instant, e.g. '2026-05-10T13:45:00Z'.
timezonestringYesIANA timezone, e.g. 'America/New_York', 'Asia/Kolkata'.

Details

From the project README

@mukundakatta/timezone-mcp

MCP server for IANA timezone conversions. Real DST rules, real offsets via the built-in Intl.DateTimeFormat. No tzdata dependency, no native binary — Node ships the IANA database.

Tools

  • convert_tz(instant, timezone) — UTC ISO → local in target tz
  • now_in(timezone) — current local time in target tz
  • tz_offset(instant, timezone) — UTC offset at that exact instant (DST-aware)

Why this exists

LLMs hallucinate timezone offsets and DST transition dates. They will confidently say "PST is UTC-8" in summer (it's PDT, UTC-7). They get India's +5:30 half-hour offset wrong. Routing through Intl.DateTimeFormat returns whatever the actual IANA rules say.

Install — Claude Desktop

{
  "mcpServers": {
    "timezone": { "command": "npx", "args": ["-y", "@mukundakatta/timezone-mcp"] }
  }
}

Same shape for Cursor / Cline / Windsurf / Zed.

License

MIT OR Apache-2.0.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.