home / mcp / date-time tools mcp server

Date-time Tools MCP Server

Provides date-time manipulation, timezone conversion, and current date-time data for apps and agents.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "abhi12299-date-time-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@abhi12299/date-time-tools"
      ]
    }
  }
}

Date-time Tools MCP provides a compact set of date-time utilities you can use as a backend helper for applications and agents. It handles timezone conversions, date mutations, and retrieving the current date-time and timezone to simplify your workflows.

How to use

You will integrate this MCP server with an MCP client (such as Cursor or Claude Desktop) by adding its configuration to your MCP setup. Once configured, you can call the available tools to convert timezones, mutate dates by adding or subtracting time, and fetch the current date-time and timezone for your context.

How to install

Prerequisites: you need Node.js and npm installed on your system to use npm/npx-based MCP commands.

Install and start using the MCP by incorporating the provided MCP server configuration into your MCP client setup. The following examples show how to reference the MCP server from two common clients.

{
  "mcpServers": {
    "date_time_tools": {
      "command": "npx",
      "args": ["-y", "@abhi12299/date-time-tools"]
    }
  }
}

If you are configuring Cursor, paste the above JSON into your Cursor MCP config at the designated location for global MCP servers. You can also place a similar file in your project under ".cursor/mcp.json" for project-scoped usage.

{
  "mcpServers": {
    "date_time_tools": {
      "command": "npx",
      "args": ["-y", "@abhi12299/date-time-tools"]
    }
  }
}

Notes and tips

After adding the MCP server configuration, you can verify its functionality by invoking the available tools for date-time operations from your MCP client. The tools include convertTimezones to switch between IANA time zones, mutateDate to add or subtract time, and currentDateTimeAndTimezone to obtain the current date-time and zone.

Available tools

convertTimezones

Converts a date-time string from one IANA timezone to another, using Luxon-compatible formats to produce correctly adjusted results across zones.

mutateDate

Mutates a date-time by adding or subtracting days, hours, minutes, months, or years, enabling easy date arithmetic.

currentDateTimeAndTimezone

Returns the current date, time, and timezone for the executing environment, useful for context-aware operations.