What it does
Chrono-mcp provides a comprehensive MCP server for date, time, timezone, and calendar operations powered by Luxon. It exposes two primary tools: GET TIME converts and formats times across IANA timezones with locale-aware output in formats like ISO, RFC2822, SQL, or custom localized strings; TIME CALCULATOR performs arithmetic operations (add, subtract, diff, duration_between) with flexible interaction modes (single-to-many, pairwise, aggregate) to handle both simple and complex temporal calculations. Output is optimized to balance information density and token efficiency.
Who it's for
Backend engineers building AI agents that require robust timezone handling and date arithmetic. Applications that perform scheduling, global time coordination, or need to display times in user-specific locales.
Common use cases
- Convert current time to multiple timezones for scheduling agents across regions
- Calculate elapsed time and durations between events for timeline analysis
- Format timestamps in locale-specific formats for user-facing output
- Perform date arithmetic (add hours or days to deadlines) in temporal workflows
Setup pitfalls
- Requires Node.js >= 22.0.0; older environments will fail at install time
- Project has no commits in 180+ days; maintenance status is unclear
- HTTP server mode requires local
npm run buildandnpm run start:http(not included in defaultnpxlaunch) - Timezone strings must be valid IANA identifiers (e.g.,
America/New_York, notESTorEDT)