io.github.rog0x/time
Timezone, dates, cron, timestamps for AI agents
Open source Open in the app JSON README (API)
About
Timezone, dates, cron, timestamps for AI agents
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- rog0x
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Last push
- 2026-03-21T20:21:24Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-08-29 04:01:19
- Updated
- 2026-08-29 04:01:19
- Origin id
io.github.rog0x/time
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 install
npm 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 install
npm run build
npm start
```