Date-time Tools MCP

A Model Context Protocol (MCP) server for date-time manipulation and timezone conversion.

Overview

This MCP server provides a set of tools for working with date-time strings, including timezone conversion, date mutation (arithmetic), and fetching the current date-time and timezone. It is designed to be used as a backend utility for applications or agents that need robust, standardized date-time operations.

Live deployment:

Architecture

This server runs on Cloudflare Workers and uses the Streamable HTTP transport (with a legacy SSE endpoint also exposed). Per-session state is backed by a Durable Object via Cloudflare's `agents` `McpAgent` wrapper.

Endpoints:

• `POST/GET/DELETE /mcp` — Streamable HTTP transport. Sessions tracked via the `mcp-session-id` header.
• `GET /sse`, `POST /sse/message` — Legacy SSE transport for older clients.

Local development

npm install
npm run dev   # wrangler dev — serves at http://127.0.0.1:8787/mcp

Deploying to Cloudflare

Manual

One-time setup:

npx wrangler login

Deploy:

npm run deploy

Wrangler prints the public URL — for this project it's `https://date-time-tools.iabhishek.workers.dev/mcp`. The Workers Free plan covers this server (100k requests/day; Durable Objects free tier covers session storage).

Automated (GitHub Actions)

`.github/workflows/deploy.yml` deploys on every push to `main` (and on manual `workflow_dispatch`). Configure two repository secrets:

• `CLOUDFLARE_API_TOKEN` — create at using the Edit Cloudflare Workers template
• `CLOUDFLARE_ACCOUNT_ID` — found on the Workers & Pages dashboard sidebar

Integration with MCP Clients

Claude Code

claude mcp add date-time-tools --transport http https://date-time-tools.iabhishek.workers.dev/mcp

Add `--scope user` to register it for every project, or `--scope project` to commit a `.mcp.json` shared with collaborators. Verify with `claude mcp list`; inside Claude Code, run `/mcp` to inspect status and tools.

Generic Streamable HTTP clients

Configure clients that support Streamable HTTP transports to point at the deployed URL:

{
  "mcpServers": {
    "date-time-tools": {
      "url": "https://date-time-tools.iabhishek.workers.dev/mcp"
    }
  }
}

For clients that only speak stdio, bridge with `mcp-remote`:

{
  "mcpServers": {
    "date-time-tools": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://date-time-tools.iabhishek.workers.dev/mcp"]
    }
  }
}

Available Tools

This MCP server provides the following tools for LLMs:

• `convertTimezones`: Convert a date-time string from one timezone to another.
• `mutateDate`: Add or subtract days, hours, minutes, months, or years from a date-time string.
• `currentDateTimeAndTimezone`: Get the current date, time, and timezone.

🧪 Testing with MCP Inspector

Run `npm run dev`, then in another terminal:

npx -y @modelcontextprotocol/inspector

Select the Streamable HTTP transport and use `http://127.0.0.1:8787/mcp` as the URL.

Features

• Timezone Conversion

Convert a date-time string from one IANA timezone to another using Luxon-compatible formats.

• Date Mutation

Add or subtract days, hours, minutes, months, or years from a date-time string.

• Current Date-Time & Timezone

Retrieve the current date, time, and timezone of the user/system.