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:

• Buy me a coffee
• Tip via Stripe ($3)