TimezoneToolkit MCP Server
@Cicatriiz
About TimezoneToolkit MCP Server
Advanced MCP server providing comprehensive time and timezone tools.
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
9Convert 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.
More Developer Tools MCP servers
Huoshan Test
volcengine
mcp-excalidraw
yctimlinMCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.
MCP Containers
metorialConnect any AI model to 1200+ integrations (MCP, CLI, API)
Unity MCP (Server + Plugin)
IvanMurzakAI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr
FastAPI-MCP
tadata-orgExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!
Comments