Time Node

MCP server for timezone-aware date and time operations

typescript

2

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "davidan90-time-node-mcp": {
      "command": "node",
      "args": [
        "/path/to/time-node-mcp/dist/index.js"
      ]
    }
  }
}

You operate a Time Node MCP Server that delivers timezone-aware date and time operations, helping AI assistants provide correct times across multiple zones. It supports current time queries, time conversions, multiple formats, DST awareness, and date utilities to keep scheduling accurate no matter where you are.

How to use

You connect to this MCP server through a client that supports MCP endpoints. Use the server to get the current time in any IANA timezone, convert times between zones, and retrieve dates with day-of-week information. Choose from ISO 8601, localized, or human-readable formats, and rely on automatic system timezone detection and correct handling of Daylight Saving Time transitions.

How to install

Prerequisites you need before installing are Node.js 18.0.0 or higher and npm or yarn.

Install and build the MCP server by following these steps:

Additional setup and notes

Configure the MCP client to load the server. The server runs locally as a stdio MCP endpoint. The runtime command is node with a direct path to the built entry point.

{
  "mcpServers": {
    "time_node_mcp": {
      "command": "node",
      "args": ["/path/to/time-node-mcp/dist/index.js"]
    }
  }
}

Usage patterns and capabilities

Get the current time in a specific IANA timezone with various formats (ISO, local, full).
Convert a given time between timezones, with optional date information.
Retrieve the system's current timezone and current date with day-of-week details.

Troubleshooting and tips

If you encounter issues, ensure your system clock and timezone are correct, and that your MCP client points to the correct local path where the server is built.

Available tools

get_current_time

Fetches the current date and time for a specified IANA timezone in a chosen format (iso, local, or full).

convert_time

Converts a given time from one timezone to another, with an optional date.

get_system_timezone

Returns the system's current timezone.

get_current_date

Returns the current date for a specified timezone, with an option to include time and day-of-week information.