date-time-tools
A Model Context Protocol (MCP) server for date-time manipulation and timezone conversion.
Installation
npx @abhi12299/date-time-toolsAsk AI about date-time-tools
Powered by Claude Β· Grounded in docs
I know everything about date-time-tools. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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: https://date-time-tools.iabhishek.workers.dev/mcp
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 themcp-session-idheader.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 https://dash.cloudflare.com/profile/api-tokens using the Edit Cloudflare Workers templateCLOUDFLARE_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.
