MCP.so
Sign In

TimezoneToolkit MCP Server

@Cicatriiz

Repository

About TimezoneToolkit MCP Server

Advanced MCP server providing comprehensive time and timezone tools.

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

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

9

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.

What transport protocols does TimezoneToolkit support?

It uses standard I/O (stdio) for MCP clients and also provides an HTTP REST API via the optional API server. No authentication is mentioned.

Frequently asked questions

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.

What transport protocols does TimezoneToolkit support?

It uses standard I/O (stdio) for MCP clients and also provides an HTTP REST API via the optional API server. No authentication is mentioned.

Comments

Basic information

Category

Developer Tools

License

ISC

Transports

stdio

Author

Cicatriiz

More Developer Tools MCP servers

Meticulous

Meticulous

MCP server and skills to connect to the Meticulous UI testing platform.

AptiBuild AI — Career Intelligence

ParklandBuilds

AptiBuild AI — Career Intelligence MCP Server Structured career decision scaffolding for AI agents. Provides personality-conditioned business idea generation, official BLS OEWS wage data, FRED labor market signals, and

extentos

Asger mølgaard

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses:

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

Skilder.ai

skilder.ai

Run skills and MCP tools like production software: versioned, composed into roles, distributed to every agent from one governed library.