English Français العربية

io.github.rog0x/time

Official registry Maps, travel and weather

Timezone, dates, cron, timestamps for AI agents

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @rog0x/mcp-time-tools
Claude Code 
claude mcp add time -- npx -y @rog0x/mcp-time-tools@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "time": {
            "command": "npx",
            "args": [
                "-y",
                "@rog0x/mcp-time-tools@1.0.2"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-time-tools
  2. Tools
  3. Setup
  4. Usage with Claude Desktop
  5. Development

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

Frequently asked questions

What is io.github.rog0x/time?

Timezone, dates, cron, timestamps for AI agents

How do I install io.github.rog0x/time?

It runs on your machine. In Claude Code: claude mcp add time -- npx -y @rog0x/mcp-time-tools@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.rog0x/time need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.rog0x/time open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.rog0x/time?

It is published by rog0x. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.