chrono-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
chrono-mcp
MCP (Model Context Protocol) server for parsing natural language date/time expressions using chrono-node.
Features
🌍 Timezone-aware parsing with simple offset values
📅 Supports relative dates, absolute dates, and date ranges
🔄 Configurable reference date and forward/backward preference
🎯 Returns both certain and implied components
⚡ Stateless HTTP transport for Cloudflare Workers
Related MCP server: Time MCP Server
Deployment
This server is designed to be deployed on Cloudflare Workers with Routes:
# Install dependencies
bun install
# Type check
bun run type-check
# Run tests
bun test
# Deploy to Cloudflare
bun run deployMCP Tool: chrono_parse
Query Parameters
You can set a default timezone offset for all requests using a query parameter:
POST https://mcp.srz.me/chrono?timezone_offset=540Benefits:
The default value will be used if
timezone_offsetis not specified in tool argumentsTool description and parameter hints are automatically updated to reflect the current default
Example: When
?timezone_offset=540is set, the tool description shows: "Default timezone: +09:00 (540 minutes from UTC)"
Input Parameters
Required
text(string): Text containing date/time expressions to parse
Optional
reference(string): Reference date/time as ISO 8601 stringExample:
"2025-10-05T10:00:00Z"or"2025-10-05T10:00:00+09:00"Default: Current time
timezone_offset(number): Timezone offset in minutes from UTCExample:
540for JST (+09:00),-300for EST (-05:00)Default: Query parameter value, or
0(UTC)
forwardOnly(boolean): Prefer future dates when ambiguousDefault:
true
mode(enum:"first"|"all"): Parse mode"first": Return first match only (default)"all": Return all matches
Output Schema
{
results: [
{
text: string // Matched text
isRange: boolean
start: {
iso: string // ISO 8601 in specified timezone
unix: number // Unix timestamp (ms)
timezoneOffset: number | null
certain: string[] // Explicit components
implied: string[] // Filled-in components
}
end?: { ... } // For ranges
}
]
summary: string // Brief description
}Example Usage
Basic parsing
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "chrono_parse",
"arguments": {
"text": "tomorrow at 3pm"
}
}
}With timezone offset in arguments
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "chrono_parse",
"arguments": {
"text": "明日の17時",
"reference": "2025-10-05T10:00:00+09:00",
"timezone_offset": 540
}
}
}With timezone offset in query parameter
# Set default timezone_offset via query parameter
POST https://mcp.srz.me/chrono?timezone_offset=540
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "chrono_parse",
"arguments": {
"text": "明日の17時"
// timezone_offset not specified, uses query parameter default (540)
}
}
}Parse all matches
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "chrono_parse",
"arguments": {
"text": "Meeting on Monday at 10am and deadline on Friday at 5pm",
"mode": "all",
"timezone_offset": 540
}
}
}Date range
{
"jsonrpc": "2.0",
"id": 5,
"method": "tools/call",
"params": {
"name": "chrono_parse",
"arguments": {
"text": "from Monday to Friday",
"timezone_offset": 0
}
}
}Timezone Offset Reference
Region | Offset (minutes) | UTC Offset |
JST (Japan) | 540 | +09:00 |
EST (US Eastern) | -300 | -05:00 |
PST (US Pacific) | -480 | -08:00 |
UTC | 0 | +00:00 |
IST (India) | 330 | +05:30 |
ACST (Australia Central) | 570 | +09:30 |
Routes Configuration
The server is configured to run at https://mcp.srz.me/chrono* using Cloudflare Routes.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Cloudflare Workers MCP server: cron-parser
Cloudflare Workers MCP server: cron-collision-detector
Cloudflare Workers MCP server: cron-monitor
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceCloudflare Worker that deploys an MCP server providing a single tool to return a user's timezone based on their IP address.-
- AlicenseNot gradedqualityDmaintenanceA Cloudflare Workers-based MCP server that provides current date and time information for any IANA timezone. It enables AI agents to retrieve precise, ISO 8601-formatted timestamps through a globally distributed edge network.MIT
- AlicenseAqualityDmaintenanceMCP server providing various date/time functions including current time, timezone conversion, and relative time calculations. Supports both local stdio and remote HTTP access via Cloudflare Workers.6243 npm2MIT
- AlicenseAqualityDmaintenanceMCP server for parsing Chinese fuzzy time expressions (e.g., '昨天', '下午3点', '中秋节') into standard datetime formats.1MIT