DateTime Context Provider is a utility MCP server that supplies LLMs with accurate current date and time information from the system clock. It enables AI agents to access precise temporal data with comprehensive timezone support. Key features of DateTime Context Provider: - Retrieve the current datetime for any IANA timezone (e.g., America/New_York, Europe/London, Asia/Tokyo). - Configurable default timezone via environment variables for consistent results. - Automatic fallback to UTC when no timezone is specified. - ISO-compatible datetime formatting with full timezone information. - Robust timezone validation and helpful error messages for invalid inputs.

@pinkpixel/datetime-mcp MCP Server ⏰

[](https://smithery.ai/server/@pinkpixel-dev/datetime-mcp)

A powerful MCP server that provides LLMs with current date and time context with comprehensive timezone support. Get the current time in any timezone, with configurable defaults and intelligent fallbacks.

This is a TypeScript-based MCP server built with the Model Context Protocol that demonstrates timezone-aware datetime functionality.

Features ✨

Tools

Installation 🚀

There are two ways to install and configure this MCP server:

Installing via Smithery

To install datetime-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @pinkpixel-dev/datetime-mcp --client claude

1. Installation from NPM (Recommended)

Install the package globally using npm:

npm install -g @pinkpixel/datetime-mcp

Then, add the following configuration to your MCP client's settings file.

#### Basic Configuration (Uses UTC)

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/datetime-mcp"
      ]
    }
  }
}

#### Configuration with Default Timezone

{
  "mcpServers": {
    "datetime": {
      "command": "npx",
      "args": [
        "-y",
        "@pinkpixel/datetime-mcp"
      ],
      "env": {
        "TZ": "America/New_York"
      }
    }
  }
}

2. Local Development Setup

If you want to run the server directly from a cloned repository for development or testing:

1. Clone the repository:

    # git clone https://github.com/pinkpixel/datetime-mcp.git
    cd datetime-mcp
    

    npm install
    

    npm run build
    

#### Basic Local Configuration

    {
      "mcpServers": {
        "datetime-local": {
          "command": "node",
          "args": ["/path/to/datetime-mcp/build/index.js"],
        }
      }
    }
    

#### Local Configuration with Timezone

    {
      "mcpServers": {
        "datetime-local": {
          "command": "node",
          "args": ["/path/to/datetime-mcp/build/index.js"],
          "env": {
            "TZ": "Europe/London"
          }
        }
      }
    }
    

🌍 Timezone Configuration Examples

Common Timezone Identifiers

#### United States

"TZ": "America/New_York"      // Eastern Time (EST/EDT)
"TZ": "America/Chicago"       // Central Time (CST/CDT)
"TZ": "America/Denver"        // Mountain Time (MST/MDT)
"TZ": "America/Los_Angeles"   // Pacific Time (PST/PDT)
"TZ": "America/Phoenix"       // Arizona (no DST)
"TZ": "America/Anchorage"     // Alaska Time
"TZ": "America/Honolulu"      // Hawaii Time

#### Europe

"TZ": "Europe/London"         // GMT/BST (Greenwich Mean Time)
"TZ": "Europe/Paris"          // CET/CEST (Central European Time)
"TZ": "Europe/Berlin"         // CET/CEST
"TZ": "Europe/Rome"           // CET/CEST
"TZ": "Europe/Madrid"         // CET/CEST
"TZ": "Europe/Amsterdam"      // CET/CEST
"TZ": "Europe/Stockholm"      // CET/CEST
"TZ": "Europe/Moscow"         // MSK (Moscow Time)

#### Asia

"TZ": "Asia/Tokyo"            // JST (Japan Standard Time)
"TZ": "Asia/Shanghai"         // CST (China Standard Time)
"TZ": "Asia/Seoul"            // KST (Korea Standard Time)
"TZ": "Asia/Kolkata"          // IST (India Standard Time)
"TZ": "Asia/Dubai"            // GST (Gulf Standard Time)
"TZ": "Asia/Singapore"        // SGT (Singapore Time)
"TZ": "Asia/Bangkok"          // ICT (Indochina Time)

#### Other Regions

"TZ": "Australia/Sydney"      // AEST/AEDT (Australian Eastern)
"TZ": "Australia/Melbourne"   // AEST/AEDT
"TZ": "Australia/Perth"       // AWST (Australian Western)
"TZ": "Pacific/Auckland"      // NZST/NZDT (New Zealand)
"TZ": "Africa/Cairo"          // EET (Eastern European Time)
"TZ": "America/Sao_Paulo"     // BRT (Brazil Time)
"TZ": "UTC"                   // Coordinated Universal Time

###