TimezoneToolkit MCP Server

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.