time-node-mcp

A Model Context Protocol (MCP) server that provides timezone-aware date and time operations. This server addresses the common issue where AI assistants provide incorrect date information due to timezone confusion.

• Accurate timezone handling - Get current time in any IANA timezone
• Time conversion - Convert time between different timezones
• Multiple formats - ISO 8601, localized, and human-readable formats
• System timezone detection - Automatically detect system timezone
• DST awareness - Correctly handles Daylight Saving Time transitions
• Date utilities - Get current date with day-of-week information

• Node.js 18.0.0 or higher
• npm or yarn

# Clone or download the project
cd time-node-mcp

# Install dependencies
npm install

# Build the TypeScript code
npm run build

Add the following configuration to your Claude Desktop settings file:

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

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

Replace /path/to/time-node-mcp/ with the actual path to your installation directory.

Get the current date and time in a specific timezone.

Parameters:

• timezone (required): IANA timezone identifier (e.g., "America/New_York", "Europe/London")
• format (optional): Output format - "iso", "local", or "full" (default: "iso")

Example:

{
  "timezone": "America/New_York",
  "format": "full"
}

Convert time from one timezone to another.

Parameters:

• sourceTimezone (required): Source IANA timezone identifier
• targetTimezone (required): Target IANA timezone identifier
• time (required): Time