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

discoverGPT

Joe Monastiero

discoverGPT is visualAI's unified MCP gateway for AI commerce, exposing 29 tools across four capabilities on one canonical product catalog: trimodal search (natural-language, precise-color, and image-similarity), AI cata

Reelier

Maxime Houle

Agents make claims. Reelier writes receipts — record an agent's tool-call workflow once, replay it deterministically at 0 tokens, and diff runs to catch drift.

Deepwiki MCP Server

regenrek

📖 MCP server for fetch deepwiki.com and get latest knowledge in Cursor and other Code Editors

1.4K

Stakpak Agent CLI

stakpak

Ship your code, on autopilot. An open source agent that lives on your machines 24/7 and keeps your apps running. 🦀

1.6K

Altronis

sypherin

MCP server + CLI for Altronis — Singapore AI consulting. Ask the Lyra consultant, generate a grant-matched AI transformation plan, pull curated SG AI events/news. Read-only, wraps altronis.sg.