time-zone-mcp

Time Zone MCP server. Query, convert, and calculate time across timezones.

No external dependencies. Pure Node.js Intl.DateTimeFormat.

Install

npm install -g time-zone-mcp

Usage

Claude Desktop / Cursor / OpenCode

Add to your MCP config:

{
  "mcpServers": {
    "time-zone": {
      "command": "npx",
      "args": ["-y", "time-zone-mcp"]
    }
  }
}

Tools

get_current_time — Get Current Time

Get the current time in one or more timezones.

Input:

{
  "timezones": ["Asia/Taipei", "America/New_York", "Europe/London"]
}

Output:

{
  "utc": "2024-01-15T02:00:00.000Z",
  "times": [
    { "timezone": "Asia/Taipei", "time": "2024-01-15T10:00:00", "offset": "UTC+08:00", "isDST": false },
    { "timezone": "America/New_York", "time": "2024-01-14T21:00:00", "offset": "UTC-05:00", "isDST": false },
    { "timezone": "Europe/London", "time": "2024-01-15T02:00:00", "offset": "UTC+00:00", "isDST": false }
  ]
}

convert_time — Convert Time

Convert a time from one timezone to another.

Input:

{
  "time": "2024-01-15T10:00:00",
  "from": "Asia/Taipei",
  "to": "America/New_York"
}

Output:

{
  "input": {
    "time": "2024-01-15T10:00:00",
    "from": "Asia/Taipei",
    "to": "America/New_York"
  },
  "result": {
    "from": "2024-01-15T10:00:00",
    "to": "2024-01-14T21:00:00",
    "fromOffset": "UTC+08:00",
    "toOffset": "UTC-05:00"
  }
}

list_timezones — List Timezones

List supported timezones. Optionally search by keyword.

Input:

{
  "search": "Asia"
}

Output:

{
  "count": 16,
  "search": "Asia",
  "timezones": [
    { "timezone": "Asia/Taipei", "time": "2024-01-15T10:00:00", "offset": "UTC+08:00" },
    { "timezone": "Asia/Tokyo", "time": "2024-01-15T11:00:00", "offset": "UTC+09:00" }
  ]
}

calculate_duration — Calculate Duration

Calculate the duration between two dates/times.

Input:

{
  "start": "2024-01-01T00:00:00Z",
  "end": "2024-12-31T23:59:59Z"
}

Output:

{
  "start": "2024-01-01T00:00:00.000Z",
  "end": "2024-12-31T23:59:59.000Z",
  "duration": "365d 23h 59m 59s",
  "days": 365,
  "hours": 8783,
  "minutes": 527039,
  "seconds": 31622399
}

Supported Timezones

50+ common timezones including:

| Region | Examples | |--------|----------| | Asia | Taipei, Tokyo, Shanghai, Hong Kong, Singapore, Seoul, Bangkok | | Europe | London, Paris, Berlin, Moscow, Rome, Madrid, Amsterdam | | America | New York, Chicago, Denver, Los Angeles, Sao Paulo, Toronto | | Australia | Sydney, Melbourne, Perth, Brisbane | | Pacific | Auckland, Fiji, Honolulu | | Africa | Cairo, Lagos, Johannesburg, Nairobi |

Design

| Feature | Why | |---------|-----| | Zero runtime deps | Only @modelcontextprotocol/sdk and zod | | Native Intl API | Uses Intl.DateTimeFormat — no moment.js needed | | DST aware | Automatically handles daylight saving time | | IANA timezones | Standard timezone names worldwide |

License

MIT