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