timezone-lookup-mcp

Looks up the current local time, UTC offset, and timezone name for any given city or geographical coordinate using the GeoNames Timezone API.

Features

• Look up timezone, local time, and UTC offset by coordinates (latitude, longitude).
• Look up timezone, local time, and UTC offset by city name (with optional 2-letter country code).
• Uses the public GeoNames Timezone API and GeoNames Search API (no API key required for demo usage).

Installation

Quick npx usage

npx @dennisk2025/timezone-lookup-mcp

Install locally (optional)

npm install @dennisk2025/timezone-lookup-mcp

Adding to Claude Desktop

Add this configuration block to your Claude Desktop config file:

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

Add this to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Usage

Tools Provided

1. lookup_by_coordinates

Get the current local time and timezone information for a given latitude and longitude.

Parameters:

• latitude (number): Latitude of the location, e.g. 40.7128
• longitude (number): Longitude of the location, e.g. -74.0060

Example Call:

{
  "name": "lookup_by_coordinates",
  "arguments": {
    "latitude": 35.6895,
    "longitude": 139.6917
  }
}

2. lookup_by_city

Get the current local time and timezone information for a given city and (optionally) country code. Uses GeoNames search API to resolve coordinates.

Parameters:

• city (string): Name of the city, e.g. Paris
• country_code (string, optional): 2-letter country code, e.g. FR

Example Call:

{
  "name": "lookup_by_city",
  "arguments": {
    "city": "Berlin",
    "country_code": "DE"
  }
}

Example Tool Responses

lookup_by_coordinates (New York):

{
  "local_time": "2024-06-09 16:15",
  "utc_offset": -4,
  "timezone_name": "America/New_York",
  "sunrise": "2024-06-09 05:24",
  "sunset": "2024-06-09 20:27"
}

lookup_by_city (Tokyo):

{
  "local_time": "2024-06-10 05:13",
  "utc_offset": 9,
  "timezone_name": "Asia/Tokyo",
  "sunrise": "2024-06-10 04:24",
  "sunset": "2024-06-10 18:56",
  "coordinates": { "latitude": 35.69, "longitude": 139.69 }
}

Tool Summary

lookup_by_coordinates

• latitude (number, required)
• longitude (number, required)

lookup_by_city

• city (string, required)
• country_code (string, optional)

API Rate Limits

This plugin uses the free/demo GeoNames API endpoints for demonstration and may be subject to rate limits or throttling. For higher usage, obtain a personal GeoNames username and update the API URLs in the source.