Time

io.github.rog0xPublished by GitHub account rog0xv1.0.2Updated Oct 24, 2026

Timezone, dates, cron, timestamps for AI agents

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

A local MCP server that gives an assistant date, timezone, cron, timestamp, and duration calculation tools.

What you can do
Provides timezone conversion, timezone listing, current time across multiple zones, and timezone difference tools. Adds date arithmetic, date differences, and business-day counting, plus cron parsing, validation, generation, and next-run calculation. Also converts between Unix timestamps and readable dates, and formats, parses, and counts down durations.
When to use it
Useful when an assistant needs reliable date and time arithmetic, timezone conversions, cron schedule explanations, or timestamp conversions instead of estimating them. Worth adding for scheduling, logging, or cross-timezone work where exact values matter.
Requirements
Runs locally as a Node.js process over stdio; the npm package @rog0x/mcp-time-tools must be installed and built, and the server is started with node pointing at its built entry file. No accounts, API keys, or network access are declared.
Before you install
The README's example configuration contains a hard-coded local file path that must be replaced with the correct path on your machine. No credentials, write actions, or third-party data sharing are described.

Installation

In SourceWeft

  1. Open Time in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-time-tools

Date, time, and timezone tools for AI agents via the Model Context Protocol (MCP).

Built entirely with native JavaScript Date and Intl APIs -- no external date libraries required.

Tools

Timezone Converter

  • convert_timezone -- Convert a date/time from one timezone to another
  • list_timezones -- List common timezones with current UTC offsets
  • current_time_multi -- Show current time in multiple timezones at once
  • time_difference -- Calculate the time difference between two timezones

Date Calculator

  • date_add_subtract -- Add or subtract days, weeks, months, or years from a date
  • date_difference -- Calculate the difference between two dates in various units
  • business_days -- Count business days between dates or add business days to a date

Cron Parser

  • parse_cron -- Parse a cron expression into a human-readable description
  • cron_next_runs -- Calculate the next N execution times for a cron expression
  • validate_cron -- Validate a cron expression and explain any errors
  • generate_cron -- Generate a cron expression from a human-readable description

Timestamp Converter

  • timestamp_to_date -- Convert Unix timestamp (seconds or milliseconds) to readable formats
  • date_to_timestamp -- Convert a date/time string to Unix timestamps
  • current_timestamp -- Get the current Unix timestamp and formatted date/time

Duration Formatter

  • format_duration -- Convert seconds to human-readable duration (e.g. 2h 30m 15s)
  • parse_duration -- Parse a human-readable duration string to seconds
  • time_ago -- Calculate relative time description (e.g. "5 minutes ago")
  • countdown -- Calculate time remaining until a target date/time

Setup

bash
npm installnpm run build

Usage with Claude Desktop

Add to your Claude Desktop configuration:

json
{  "mcpServers": {    "time-tools": {      "command": "node",      "args": ["D:/products/mcp-servers/mcp-time-tools/dist/index.js"]    }  }}

Development

bash
npm installnpm run buildnpm start

Source: README.md at commit 332b54d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.