TimezoneToolkit MCP Server

Name: TimezoneToolkit MCP Server
Author: Cicatriiz

@Cicatriiz

Repository

About TimezoneToolkit MCP Server

Advanced MCP server providing comprehensive time and timezone tools.

#datetime #timezone #mcp #timezone-conversion #timezone-toolkit

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "timezone-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "@cicatriz/timezone-toolkit@latest"
      ]
    }
  }
}

Tools

Convert a time from one timezone to another

Get the current time in a specified timezone

Calculate sunrise, sunset, and twilight times for a specific location and date

Calculate moon phase for a specific date

Calculate the time difference between two timezones

List available IANA timezones, optionally filtered by region

Calculate time remaining until a specific date/event

Calculate business days between two dates (excluding weekends)

Format a date in various styles

Overview

What is TimezoneToolkit?

TimezoneToolkit is an MCP (Model Context Protocol) server that provides advanced time and timezone tools, including conversion, current time, sunrise/sunset and moon phase calculations, countdowns, business day counts, and date formatting. It integrates with any MCP‑compatible client such as Claude Desktop, Cursor, Windsurf, Cline, or Roo Code.

How to use TimezoneToolkit?

Install with npx -y @cicatriz/timezone-toolkit@latest or via npm. Add the server configuration to your MCP client’s settings file (e.g., claude_desktop_config.json) using the command npx -y @cicatriz/timezone-toolkit. Optionally run the RESTful API server with node server.js to access tools over HTTP.

Key features of TimezoneToolkit

Convert times between any IANA timezone
Get current time in any timezone
Calculate sunrise, sunset, and twilight times
Compute moon phase and illumination
List IANA timezones filtered by region
Calculate business days excluding weekends
Format dates in multiple styles and locales
Create countdown timers to future events
Calculate timezone differences in hours and minutes
Offer both MCP and REST API access

Use cases of TimezoneToolkit

Convert meeting times across global timezones
Plan outdoor activities using sunrise/sunset data
Track moon phases for astronomy or photography
Count down days to holidays, deadlines, or events
Compute business days between project dates

FAQ from TimezoneToolkit

What are the prerequisites for TimezoneToolkit?

Node.js 18.x or higher is required to run the server.

How do I install and configure TimezoneToolkit?

You can run it with npx -y @cicatriz/timezone-toolkit@latest, install globally from npm, or clone and build manually. Then add the command to your MCP client’s settings file (e.g., for Claude Desktop use claude_desktop_config.json).

Can I use TimezoneToolkit without an MCP client?

Yes. You can start the REST API server with node server.js, which provides endpoints such as /api/convert-time, /api/sunrise-sunset, and more.

Does TimezoneToolkit exclude holidays in business day calculations?

The calculate_business_days tool can exclude common US holidays when the excludeHolidays parameter is set to true. Other holidays are not supported.