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

npm install
npm run build

Usage with Claude Desktop

Add to your Claude Desktop configuration:

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

Development

npm install
npm run build
npm start