io.github.nexus-api-lab/chrono-mcp

Official6 tools

Deterministic time tools for AI agents: timezone conversion, business-day math, cron interpretation.

Time conversion and calculation tools: timezones, business days, cron expressions.

Captured live from the server via tools/list.

current_time

Get the current date and time in a given IANA timezone, with UTC offset and day of week. Use this instead of guessing the current time.

Parameters (1)

timezonestringrequired
Target timezone. IANA timezone, e.g. "Asia/Tokyo", "America/New_York", "UTC".

convert_time

Convert a date-time from one IANA timezone to another, handling DST correctly. Use this instead of doing timezone arithmetic yourself.

Parameters (3)

datetimestringrequired
Date-time as "YYYY-MM-DD HH:mm[:ss]" (interpreted in from_timezone) or full ISO 8601 with offset.
from_timezonestringrequired
Timezone the input is expressed in. IANA timezone, e.g. "Asia/Tokyo", "America/New_York", "UTC".
to_timezonestringrequired
Timezone to convert to. IANA timezone, e.g. "Asia/Tokyo", "America/New_York", "UTC".

add_business_days

Add (or subtract, with a negative count) N business days to a date, skipping weekends and any supplied holidays. Returns the resulting date.

Parameters (3)

start_datestringrequired
"YYYY-MM-DD".
daysintegerrequired
Number of business days to add. Negative subtracts.
holidaysarray
Optional list of holiday dates to treat as non-business days, each "YYYY-MM-DD". Weekends (Sat/Sun) are always non-business days.

business_days_between

Count business days between two dates (start inclusive, end exclusive), skipping weekends and any supplied holidays.

Parameters (3)

start_datestringrequired
"YYYY-MM-DD", inclusive.
end_datestringrequired
"YYYY-MM-DD", exclusive.
holidaysarray
Optional list of holiday dates to treat as non-business days, each "YYYY-MM-DD". Weekends (Sat/Sun) are always non-business days.

next_cron_runs

Compute the next N run times of a standard 5-field cron expression ("minute hour day-of-month month day-of-week") in a given timezone. Use this instead of interpreting cron expressions yourself.

Parameters (4)

cronstringrequired
5-field cron expression, e.g. "*/15 9-17 * * MON-FRI".
countinteger
How many upcoming run times to return (1-50). Default 5.
timezonestringrequired
Timezone the cron schedule is defined in. IANA timezone, e.g. "Asia/Tokyo", "America/New_York", "UTC".
fromstring
Optional ISO 8601 datetime to compute from. Defaults to now.

duration_between

Compute the exact duration between two date-times, with a breakdown into days/hours/minutes/seconds. Handles timezones and DST correctly.

Parameters (3)

startstringrequired
Start date-time, "YYYY-MM-DD HH:mm[:ss]" or ISO 8601.
endstringrequired
End date-time, same formats.
timezonestring
Timezone for inputs that lack an explicit offset. Default UTC. IANA timezone, e.g. "Asia/Tokyo", "America/New_York", "UTC".

Install

claude_desktop_config.json

{
  "mcpServers": {
    "chrono-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://chrono-mcp.dokasukadon.workers.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.