home / mcp / chrono mcp server

Chrono MCP Server

Provides time, calendar, timezone, lunar calendar, almanac, and date utilities for MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aleck31-mcp-chrono": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-chrono"
      ]
    }
  }
}

You have access to an MCP server named Chrono that provides time, calendar, timezone, Chinese lunar calendar, almanac, and date utilities for AI agents. It helps you perform time calculations, convert time zones, explore calendars and festivals, and manage persistent countdowns, all through MCP-compatible clients.

How to use

To use Chrono with your MCP clients, start by running the server locally or connect to it via an MCP client that supports the standard mcp.json configuration. The server exposes a suite of time-related tools that you can call from your client, such as getting the current time in a specific timezone, converting between time zones, calculating dates in Gregorian or lunar calendars, and querying calendars and almanac data. You will configure your MCP client to load Chrono as a server under the name chrono, then invoke its tools using the standard mcp interface.

Practical usage patterns

- Get the current time in a selected IANA timezone and format it for display.

- Convert a date between two timezones to support scheduling across regions.

- Calculate a date by adding or subtracting years, months, days, or hours in either the Gregorian or lunar calendar or anchored to a named festival.

- Retrieve festivals and public holidays within a date range for a given region, or compare month information.

- Use the Chinese Almanac for auspicious activities, directions, and other traditional data for a specific date.

Connecting Chrono to MCP clients

Chrono can be connected to MCP clients using local, stdio-based configurations. The following example shows a typical setup that runs Chrono via Node Package Executor (npx). You can adapt this for your preferred MCP client by printing the exact command and arguments in your client’s config.

Example usage through a standard MCP client config uses the command and arguments shown below.

Available tools

get_current_time

Fetch the current time in a specified IANA timezone with detailed components such as timestamp, weekday, week of year, day of year, and UTC offset.

convert_timezone

Convert a datetime between two IANA timezones.

list_timezones

Search IANA timezones with current offsets and Chinese city names.

parse_timestamp

Parse Unix timestamps or ISO 8601 strings into date components.

calculate_time

Add or subtract time from a base date in Gregorian, lunar, or anchor modes (festival-based).

date_diff

Compute the difference between two dates in years, months, days, hours, and minutes.

countdown

Count down to a target date with remaining time components.

calculate_business_days

Count or add business days, skipping weekends and holidays, with CN makeup workdays support.

convert_calendar

Convert between Gregorian and Chinese Lunar calendars and obtain related data like Ganzhi, zodiac, and solar terms.

get_festivals

List festivals, solar terms, and public holidays within a date range.

get_month_info

Retrieve detailed information about a specific month, including day count and weekday data.

get_almanac

Fetch Chinese almanac entries for a date, including auspicious activities and related details.

manage_countdown

Create, read, update, and delete persistent countdown timers stored on disk.