TimezoneToolkit MCP Server logo

TimezoneToolkit MCP Server

by Cicatriiz

TimezoneToolkit MCP Server is an advanced server providing comprehensive time and timezone tools. It offers enhanced features beyond basic conversion, accessible through the Model Context Protocol (MCP).

View on GitHub

Last updated: N/A

What is TimezoneToolkit MCP Server?

TimezoneToolkit is an MCP server that provides a suite of tools for time and timezone calculations, including timezone conversion, sunrise/sunset calculations, moon phase calculations, date formatting, countdown timers, and business day calculations. It's designed to integrate with applications like Claude Desktop, Cursor, Windsurf, Cline and Roo Code.

How to use TimezoneToolkit MCP Server?

To use TimezoneToolkit, you need to install it using npm or by cloning the repository. Then, configure your client application (e.g., Claude Desktop, Cursor) to use the server by adding the appropriate MCP configuration. Alternatively, it can be used as a CLI tool or via a RESTful API.

Key features of TimezoneToolkit MCP Server

  • Basic Timezone Conversion

  • Sunrise/Sunset and Astronomical Calculations

  • Date and Time Utilities

  • RESTful API access

  • Integration with Claude Desktop and other IDEs

  • Comprehensive testing framework

Use cases of TimezoneToolkit MCP Server

  • Converting times between different timezones

  • Calculating sunrise and sunset times for a specific location

  • Determining the moon phase for a given date

  • Calculating the number of business days between two dates

  • Creating countdown timers for future events

  • Formatting dates in various styles and locales

FAQ from TimezoneToolkit MCP Server

How do I install TimezoneToolkit?

You can install it globally using npm (npm install -g @cicatriz/timezone-toolkit), clone the repository and install dependencies, or use npx to run it directly.

How do I configure TimezoneToolkit with Claude Desktop?

Add the MCP server configuration to your claude_desktop_config.json file, specifying the command and arguments to run the server.

What timezones are supported?

TimezoneToolkit supports all IANA timezones. You can list available timezones using the list_timezones tool.

Can I access TimezoneToolkit programmatically?

Yes, TimezoneToolkit provides a RESTful API for accessing its functionality. Start the API server using node server.js and use the available API endpoints.

What are the dependencies for TimezoneToolkit?

The main dependencies are Node.js (18+), Luxon for date/time handling, SunCalc for astronomical calculations, and @modelcontextprotocol/sdk for MCP server implementation.