Skip to main content
Glama
mcp-datetime

mcp-datetime

by hlteoh37

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

Related MCP server: MCP Node Time

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

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:

Available Tools

10 tools
business_daysA

Calculate business days between two dates, or add N business days to a date. Excludes weekends (Sat/Sun).

Inputs: start (required), operation (required), end, days.

convert_timezoneB

Convert a date/time from one timezone to another.

Inputs: to_tz (required), from_tz (required), datetime (required).

countdownC

Calculate time remaining until a target date, or time elapsed since a past date.

Inputs: target (required), from.

date_diffA

Calculate the difference between two dates in multiple units (days, hours, minutes, seconds, weeks, business days).

Inputs: to (required), from (required).

date_infoA

Get detailed information about a date: day of week, ISO week number, day of year, leap year, quarter, and more.

Inputs: date (required).

date_mathB

Add or subtract time from a date. Supports years, months, days, hours, minutes, seconds.

Inputs: add (required), date (required).

explain_cronA

Explain a cron expression in plain English. Supports standard 5-field cron format (minute hour dom month dow).

Inputs: expression (required).

format_dateA

Format a date/time using a format string. Tokens: YYYY, MM, DD, HH, mm, ss, SSS.

Inputs: date (required), format (required).

nowA

Get the current date and time in one or more timezones. Returns ISO 8601, Unix timestamp, and human-readable format.

Inputs: timezones.

unix_timestampA

Convert between Unix timestamps and ISO 8601 dates. Pass a timestamp to get ISO, or a date to get timestamp.

Inputs: value (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools have distinct purposes, but date_diff, countdown, and business_days all involve date differences, creating potential confusion. Descriptions help clarify boundaries, but the overlap between date_diff and countdown remains somewhat vague.

    Naming Consistency2/5

    Tool names use a mix of verb_noun (convert_timezone, format_date, explain_cron), noun phrases (date_math, unix_timestamp, business_days, countdown, date_info), and a bare keyword (now). No consistent convention is followed.

    Tool Count5/5

    10 tools is well-scoped for a datetime utility server, covering current time, conversions, arithmetic, formatting, business days, and cron explanation without unnecessary bloat.

    Completeness4/5

    The set covers most core datetime operations, but lacks a general date string parser (only unix_timestamp converts to/from ISO) and business_days excludes holidays, not just weekends. These are minor gaps that agents can work around.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      The Time MCP Server is a Model Context Protocol (MCP) server that provides AI assistants and other MCP clients with standardized tools to perform time and date-related operations. This server acts as a bridge between AI tools and a robust time-handling back
      167 npm
      25
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A MCP server that provides timezone-aware date and time operations. This server addresses the common issue where AI assistants provide incorrect date information due to timezone confusion.
      4
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Time MCP Server is a server implementation that provides time aware capabilities for large language models, supporting functions such as obtaining current time, relative time, and timestamp conversion.
      6
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Lightweight MCP server providing system time tools (current time, date, datetime, time components, unix timestamp) for LLM applications.
      1
      MIT