mcp-datetime
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| nowA | Get the current date and time in one or more timezones. Returns ISO 8601, Unix timestamp, and human-readable format. |
| convert_timezoneB | Convert a date/time from one timezone to another. |
| date_mathB | Add or subtract time from a date. Supports years, months, days, hours, minutes, seconds. |
| date_diffA | Calculate the difference between two dates in multiple units (days, hours, minutes, seconds, weeks, business days). |
| format_dateA | Format a date/time using a format string. Tokens: YYYY, MM, DD, HH, mm, ss, SSS. |
| unix_timestampA | Convert between Unix timestamps and ISO 8601 dates. Pass a timestamp to get ISO, or a date to get timestamp. |
| business_daysA | Calculate business days between two dates, or add N business days to a date. Excludes weekends (Sat/Sun). |
| explain_cronA | Explain a cron expression in plain English. Supports standard 5-field cron format (minute hour dom month dow). |
| countdownC | Calculate time remaining until a target date, or time elapsed since a past date. |
| date_infoA | Get detailed information about a date: day of week, ISO week number, day of year, leap year, quarter, and more. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.