mcp-datetime
MCP server with 10 date & time tools for LLMs. Timezone conversion, date math, cron explanation, business days, Unix timestamps, and more. Zero dependencies beyond the MCP SDK.
Tools
| Tool | Description | |------|-------------| | now | Current time in multiple timezones | | convert_timezone | Convert between 60+ timezones (IANA, abbreviations, UTC offsets) | | date_math | Add/subtract years, months, days, hours, minutes, seconds | | date_diff | Difference between dates in days, hours, weeks, business days | | format_date | Format dates with custom tokens (YYYY-MM-DD HH:mm:ss) | | unix_timestamp | Convert between Unix timestamps and ISO 8601 | | business_days | Count or add business days (excludes weekends) | | explain_cron | Explain cron expressions in plain English | | countdown | Time remaining/elapsed to a target date | | date_info | Day of week, ISO week, quarter, leap year, day of year |
Quick Start
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"datetime": {
"command": "npx",
"args": ["-y", "mcp-datetime"]
}
}
}Cursor / VS Code
Add to MCP settings:
{
"mcp": {
"servers": {
"datetime": {
"command": "npx",
"args": ["-y", "mcp-datetime"]
}
}
}
}Supported Timezones
60+ timezones including:
- Abbreviations: UTC, GMT, EST, EDT, CST, CDT, MST, MDT, PST, PDT, CET, CEST, IST, JST, KST, SGT, MYT, AEST, NZST, and more
- IANA names: Asia/Tokyo, America/New_York, Europe/London, Australia/Sydney, etc.
- UTC offsets: +05:30, -08:00, +09, etc.
Examples
"What time is it in Tokyo and New York?" → Uses now with ["JST", "EST"]
"Add 90 business days to March 1, 2026" → Uses business_days with operation: "add"
*"What does 0 /6 mean?"* → Uses explain_cron → "Runs at minute 0 of every 6 hours"
"How many days until December 25?" → Uses countdown with target date
Part of the MCP Tools Suite
- mcp-devutils — 19 developer utility tools
- mcp-apitools — 7 API & HTTP tools
- mcp-texttools — 8 text processing tools
- mcp-mathtools — 12 math & statistics tools
- mcp-datetime — 10 date & time tools ← you are here
- mcp-quick-calc — 5 calculator tools: currency conversion, percentages, compound interest, unit conversion, loan payments
- readmecraft — README generator
- mcp-all-tools — All 60+ tools in a single MCP server
60+ MCP tools across 7 packages. Install any combination you need.
Like this? Try mcp-devutils
mcp-devutils — 44 developer tools in one MCP server. UUID, hash, JWT, JSON diff, AES encryption, and more. 15 free, unlock all 44 for $5.
License
MIT
Support
If this tool saves you time, consider supporting development:
