mcp-datetime
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-datetime How many days until December 25?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Current time in multiple timezones |
| Convert between 60+ timezones (IANA, abbreviations, UTC offsets) |
| Add/subtract years, months, days, hours, minutes, seconds |
| Difference between dates in days, hours, weeks, business days |
| Format dates with custom tokens (YYYY-MM-DD HH:mm:ss) |
| Convert between Unix timestamps and ISO 8601 |
| Count or add business days (excludes weekends) |
| Explain cron expressions in plain English |
| Time remaining/elapsed to a target date |
| 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
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:
Available Tools
10 toolsbusiness_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
Scored across 10 tools
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.
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.
10 tools is well-scoped for a datetime utility server, covering current time, conversions, arithmetic, formatting, business days, and cron explanation without unnecessary bloat.
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
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
The Remote MCP server acts as a standardized bridge between LLM applications (like Claude, ChatGPT, and Cursor) and external services, enabling AI agents to access external tools and resources. Its primary capability is providing a centralized search tool to discover other MCP servers and their respective tools. Unlike local implementations, it runs remotely with OAuth authentication and permission controls for security.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceThe 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 back167 npm25MIT
- AlicenseAqualityDmaintenanceA 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.45MIT
- AlicenseBqualityDmaintenanceTime 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.62Apache 2.0
- AlicenseNot gradedqualityDmaintenanceLightweight MCP server providing system time tools (current time, date, datetime, time components, unix timestamp) for LLM applications.1MIT