MCP 服务器

mcp-datetime

MCP server providing 10 date and time tools including timezone conversion, date math, cron explanation, business days calculation, and more, enabling LLMs to handle datetime operations.

README

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