About time
An MCP server offering AI agents date, time, and timezone utilities using native JavaScript Date and Intl APIs. It also handles cron expressions, timestamps, and durations.
Key features
- 01Convert timezones and compare their offsets
- 02Calculate date differences, business days, and date shifts
- 03Parse, validate, and generate cron expressions
- 04Convert between Unix timestamps and dates
- 05Parse and format durations and calculate countdowns
Use cases
- 01Check current times across multiple timezones
- 02Calculate project dates and business-day intervals
- 03Inspect scheduled jobs and their upcoming run times
- 04Convert timestamps or find time remaining until a target
MCP support
The MCP server provides AI agents with tools for timezones, dates, cron expressions, timestamps, and durations.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
18Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| datetime | string | Yes | Date/time string (ISO 8601 or common formats, e.g. 2025-06-15T14:30:00) |
| to_timezone | string | Yes | Target timezone (e.g. Asia/Tokyo) |
| from_timezone | string | Yes | Source timezone (e.g. America/New_York) |
Details
From the project READMEmcp-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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.