Date-Time MCP Server

A Model Context Protocol (MCP) server that provides current date and time information from the running machine.

Features

• Provides a single tool: current-date-time
• Returns comprehensive time information including:
  • ISO 8601 timestamp
  • IANA timezone name
  • UTC offset
  • Unix timestamp
  • Human-readable formatted date and time
• Uses stdio transport for local communication
• Built with the official MCP TypeScript SDK

Requirements

• Node.js 24.11.0

Installation

npm install

Usage

Running the Server

npm start

Or directly:

node index.js

Integrating with MCP Clients

To use this server with an MCP client (like Claude Desktop), add it to your MCP settings configuration:

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "date-time": {
      "command": "node",
      "args": ["/absolute/path/to/date-time-mcp/index.js"]
    }
  }
}

Replace /absolute/path/to/date-time-mcp with the actual path to this directory.

Tool Reference

current-date-time

Returns the current date and time information from the machine running the server.

Input: None (empty object)

Output:

• timestamp (string): ISO 8601 formatted timestamp
• timezone (string): IANA timezone name (e.g., "America/New_York")
• utcOffset (string): UTC offset in format +/-HH:MM
• unixTimestamp (number): Unix timestamp in milliseconds
• formattedDate (string): Human-readable date (e.g., "Monday, November 10, 2025")
• formattedTime (string): Human-readable time (e.g., "02:30:45 PM")

Example Response:

{
  "timestamp": "2025-11-10T14:30:45.123Z",
  "timezone": "America/New_York",
  "utcOffset": "-05:00",
  "unixTimestamp": 1731247845123,
  "formattedDate": "Monday, November 10, 2025",
  "formattedTime": "09:30:45 AM"
}

Development

The server uses:

• @modelcontextprotocol/sdk - Official MCP TypeScript SDK
• zod - Schema validation
• stdio transport for process communication

License

MIT