Date Operations

The Date Operations MCP exposes common date/time calculations over an HTTP stream, powered by date-fns. It lets you get the current time, format dates, add or subtract durations, compute differences, and compare dates in a lightweight MCP server that integrates with your MCP clients.

How to use

Connect your MCP client to the Date Operations MCP at the HTTP stream endpoint. You can perform a variety of date/time operations through the MCP protocol: now, format, add, subtract, difference, and check. This enables you to perform date calculations within your apps or automation flows without building your own date utilities.

How to install

Prerequisites: ensure you have Node.js 18 or newer installed on your system.

# Install dependencies
npm install

Start the server in development mode to test locally.

npm run dev
# Server listens on http://localhost:3000 (HTTP stream)

For production, build and run the compiled output.

npm run build
npm start
# Outputs to dist/ and runs Node on dist/index.js

Configuration and client usage notes

The server uses an HTTP stream transport suitable for MCP-aware clients. Point your MCP client to the following URL.

{
  "type": "http",
  "name": "date_operations",
  "url": "http://localhost:3000",
  "args": []
}

Security, notes, and troubleshooting

Dates are handled as ISO 8601 strings (UTC is recommended). The format operation accepts Unicode tokens per date-fns (UTS #35). For add and subtract, provide all duration fields, using 0 for unused values. If you encounter connection issues, verify that the MCP endpoint is reachable at http://localhost:3000 and that your MCP client is configured for an HTTP stream transport.

Available tools

now

Get the current date/time as an ISO 8601 string.

format

Format a date string using Unicode tokens per date-fns to produce a human-readable result.

add

Add a duration to a date. Supply all duration fields; use 0 for any unused field.

subtract

Subtract a duration from a date. Supply all duration fields; use 0 for any unused field.

difference

Compute the difference between two dates in a specified unit (seconds, minutes, hours, days, weeks, months, years).

check

Compare two dates with operators after, before, or equal and obtain a boolean result.