Skip to main content
Glama

@mcpx-digital/timezone

MCP server for IANA timezone conversion, cross-zone “what time when”, and meeting overlap windows.

Pure date-fns-tz / Intl — no external time APIs, no network calls.

Install (MCPX / npx)

npx -y @mcpx-digital/timezone

Prepared for npm as @mcpx-digital/timezone. Until published, run from a local clone.

Related MCP server: Time MCP Server

Cursor mcp.json example

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

Local clone:

{
  "mcpServers": {
    "timezone": {
      "command": "node",
      "args": ["/absolute/path/to/timezone-mcp/index.js"]
    }
  }
}

Tools

Tool

What it does

convert_timezone

Convert a moment between IANA zones

what_time_when

“What time is it in X when it’s Y in Z?”

meeting_overlap

Overlapping slots for N participants’ work hours

list_common_zones

Curated common IANA zone list

Example prompts

  • “Convert 3pm UTC to America/Los_Angeles”

  • “When it’s 9:00 in Tokyo, what time is it in New York on 2026-09-12?”

  • “Find 30-minute meeting slots for NY 9–17 and London 9–17 on 2026-03-10”

Development

git clone https://github.com/TheoryofShadows/timezone-mcp.git
cd timezone-mcp
npm install
npm test
node index.js

Sell / list on MCPX

Suggested listing price: $5.

Install command: npx -y @mcpx-digital/timezone

License

MIT © TheoryofShadows

Available Tools

4 tools
convert_timezoneB

Convert a moment between IANA timezones. Uses local date-fns-tz / Intl only — no external time APIs.

Inputs: toZone (required), to, from, when, +1 more.

list_common_zonesA

List a curated set of common IANA timezones. Uses local date-fns-tz / Intl only — no external time APIs.

Inputs: no named parameters.

meeting_overlapB

Find overlapping meeting slots for N participants with local work hours on a date. Uses local date-fns-tz / Intl only — no external time APIs.

Inputs: participants (required), date, maxSlots, stepMinutes, +1 more.

what_time_whenB

Answer: what time is it in targetZone when it is localTime in sourceZone. Uses local date-fns-tz / Intl only — no external time APIs.

Inputs: localTime (required), sourceZone (required), targetZone (required), date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 4 tools

    Disambiguation3/5

    convert_timezone and what_time_when both perform timezone conversions, making their boundaries blurry; descriptions hint at different input framing but overlap remains. list_common_zones and meeting_overlap are clearly distinct.

    Naming Consistency3/5

    All names use lower snake_case, but the structural pattern is mixed: convert_timezone and list_common_zones are verb-led, what_time_when is a question phrase, and meeting_overlap is noun-led. Readable but not predictably consistent.

    Tool Count4/5

    Four tools is a reasonable scope for a focused timezone utility, and each tool targets a plausible need. The pair of conversion tools is slightly redundant but not excessive.

    Completeness4/5

    Core timezone conversion, zone listing, and meeting overlap functionality are covered. Minor gaps remain, such as current-time-in-zone or zone lookup by city/offset, but these are workable around.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides current time information and timezone conversion capabilities using IANA timezone names. Enables LLMs to get current time in any timezone and convert times between different timezones with automatic system timezone detection.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides current time and timezone conversion using IANA timezone names, enabling LLMs to get system time or convert times between timezones.
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides current time and timezone conversion using IANA timezone names, enabling LLMs to get time information and convert times between timezones.
      2
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides accurate time zone conversions, DST-safe scheduling, holidays for 200+ countries, business day calculations, and cross-zone meeting slot suggestions.
      5
      1
      MIT