MCPs
Time Node MCP Server

Time Node MCP Server

Timezone-aware date and time operations for AI assistants and applications.

Stars

Forks

Watchers

Issues

Time Node MCP Server is an implementation of the Model Context Protocol (MCP) designed to provide accurate, timezone-aware date and time operations. It exposes tools for retrieving and converting times across IANA timezones, detecting system timezone, and offering outputs in multiple formats. The server ensures correct handling of Daylight Saving Time transitions and supports integration with AI assistants like Claude Desktop.

Key Features

Accurate timezone handling using IANA identifiers

Conversion of times between different timezones

Support for ISO 8601, localized, and human-readable output formats

Automatic system timezone detection

Daylight Saving Time awareness

Date utilities including current date with day-of-week

Integration with Claude Desktop via MCP

TypeScript-based implementation

Easy server setup using Node.js

Multiple tool endpoints for flexible usage

Use Cases

Providing AI assistants with the correct date and time in any timezone

Automating scheduling and meeting coordination across timezones

Converting meeting or event times between regions

Travel planning with accurate time difference calculations

Supporting international collaboration by normalizing times

Fetching current system timezone information for context-aware applications

Generating formatted timestamps for logs or records

Handling Daylight Saving Time changes programmatically

Providing precise day-of-week information for user queries

Integrating date and time operations in AI-powered desktop applications

README

Time Node MCP Server

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.

Features

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

Installation

Prerequisites

Node.js 18.0.0 or higher
npm or yarn

Install and Build

bash

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

# Install dependencies
npm install

# Build the TypeScript code
npm run build

Usage with Claude Desktop

Add the following configuration to your Claude Desktop settings file:

macOS

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

Windows

%APPDATA%\Claude\claude_desktop_config.json

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.

Available Tools

1. get_current_time

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:

json

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

2. convert_time

Convert time from one timezone to another.

Parameters:

sourceTimezone (required): Source IANA timezone identifier
targetTimezone (required): Target IANA timezone identifier
time (required): Time in HH:MM or HH:MM:SS format (24-hour)
date (optional): Date in YYYY-MM-DD format (uses current date if not provided)

Example:

json

{
  "sourceTimezone": "America/New_York",
  "targetTimezone": "Europe/London",
  "time": "14:30",
  "date": "2024-08-12"
}

3. get_system_timezone

Get the system's current timezone with current time information.

Parameters: None

4. get_current_date

Get the current date in a specific timezone with day-of-week information.

Parameters:

timezone (required): IANA timezone identifier
includeTime (optional): Whether to include time information (default: false)

Example:

json

{
  "timezone": "Asia/Tokyo",
  "includeTime": true
}

Development

Scripts

bash

# Build the project
npm run build

# Build and watch for changes
npm run dev

# Run the server directly (after building)
npm start

# Lint the code
npm run lint

# Type check
npm run typecheck

Project Structure

time-node-mcp/
├── src/
│   ├── index.ts           # Main MCP server implementation
│   ├── time-service.ts    # Core time/timezone functionality
│   └── interfaces.ts      # TypeScript interfaces
├── dist/                  # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

Common Use Cases

Correct current date/time: When Claude needs to know "what day is today" in your timezone
Meeting scheduling: Convert meeting times between different timezones
Travel planning: Understand time differences when traveling
International coordination: Work with teams across multiple timezones

Timezone Support

This server supports all IANA timezone identifiers, including:

America/New_York
Europe/London
Asia/Tokyo
Australia/Sydney
Pacific/Auckland
And many more...

You can find a complete list of supported timezones at: https://en.wikipedia.org/wiki/List_of_tz_database_time_zones

Error Handling

The server provides comprehensive error handling for:

Invalid timezone identifiers
Malformed time formats
Invalid date formats
System errors

All errors are returned in a structured JSON format with descriptive messages.

Contributing

Fork the repository
Create a feature branch
Make your changes
Run tests and linting
Submit a pull request

License

MIT License - see LICENSE file for details.

Troubleshooting

Common Issues

"Invalid timezone" error:

Ensure you're using valid IANA timezone identifiers
Check spelling and capitalization (e.g., "America/New_York", not "america/new_york")

MCP server not connecting:

Verify the path in your Claude Desktop configuration is correct
Ensure the project is built (npm run build)
Check that Node.js is installed and accessible

Date/time seems incorrect:

The server uses your system's current date/time as the base
Ensure your system clock is correct and timezone is properly set

Star History

Repository Owner

davidan90

User

Repository Details

Language TypeScript

Default Branch main

Size 30 KB

Contributors 1

License MIT License

MCP Verified Nov 12, 2025

Programming Languages

TypeScript

51.27%

JavaScript

48.73%

Related MCPs

Discover similar Model Context Protocol servers

mcp-time

A Model Context Protocol server for time and date operations

mcp-time is a Model Context Protocol (MCP) server that enables AI assistants and MCP clients to perform standardized time and date-related operations. It provides natural language parsing for relative time expressions, supports flexible formatting, and allows manipulation and comparison of times. The server offers multiple integration methods, including stdio, HTTP stream, Docker, and npx for compatibility with various clients. It is designed for robust time handling and easy integration with AI tools.

⭐ 8
MCP
TheoBrigitte/mcp-time

MCP Simple Timeserver

Provides local and UTC time to AI models via the Model Context Protocol.

MCP Simple Timeserver provides current local time, timezone, and UTC information to AI models such as Claude by serving as a Model Context Protocol (MCP) tool. It offers two main endpoints: one for retrieving the user's local time and timezone, and another for fetching the current UTC time from an NTP server. The project supports both local and web server deployments and can be integrated into the Claude desktop app to enhance temporal awareness for LLMs.

⭐ 25
MCP
andybrandt/mcp-simple-timeserver

mcp-datetime

Datetime formatting service MCP server for Claude Desktop App

mcp-datetime provides a datetime formatting service implemented as an MCP server for integration with the Claude Desktop Application. It offers generation of current date and time strings in various formats, including standard, Japanese, ISO, and filename-friendly outputs. The server exposes a 'get_datetime' tool for easy retrieval of formatted dates and times with support for timezone handling and multi-language output. Seamless integration and Python packaging facilitate installation and extensibility.

⭐ 25
MCP
ZeparHyfar/mcp-datetime

MCP-timeserver

A simple MCP server providing date and time information to agentic systems.

MCP-timeserver exposes current datetime information via a custom datetime URI scheme compatible with the Model Context Protocol. It allows agentic systems and chat REPLs to access timezone-aware current times and offers a tool to fetch the system's local time. The server is designed to integrate with MCP-based workflows by providing standardized datetime resources.

⭐ 39
MCP
SecretiveShell/MCP-timeserver

Stadia Maps MCP Server (TypeScript)

Bringing location services, geocoding, and mapping to AI assistants via Stadia Maps APIs.

Stadia Maps MCP Server (TypeScript) implements the Model Context Protocol to provide LLM-based assistants with structured access to Stadia Maps APIs. It enables AI tools to query for geocoding, routing, time zones, map generation, and isochrone calculations. Designed for integration with agentic tools and LLMs, the server enhances spatial intelligence and location-based features in AI workflows.

⭐ 18
MCP
stadiamaps/stadiamaps-mcp-server-ts

MCP Weather Server

Provides weather forecasts to LLMs via the Model Context Protocol.

MCP Weather Server enables large language models to access real-time, accurate weather forecasts by interfacing with the AccuWeather API. It offers both hourly and daily weather data, supporting metric and imperial units, and can be seamlessly integrated with MCP-compatible clients like Claude Desktop or supergateway. The server provides tools for retrieving weather based on location and settings, with robust configuration options. It is designed for straightforward deployment using Node.js and environment-configured API keys.

⭐ 27
MCP
TimLukaHorstmann/mcp-weather

View all Alternatives

Didn't find tool you were looking for?

Search AI Tools

Time Node MCP Server

Key Features

Use Cases

README

Time Node MCP Server

Features

Installation

Prerequisites

Install and Build

Usage with Claude Desktop

macOS

Windows

Available Tools

1. get_current_time

2. convert_time

3. get_system_timezone

4. get_current_date

Development

Scripts

Project Structure

Common Use Cases

Timezone Support

Error Handling

Contributing

License

Troubleshooting

Common Issues

Star History

Repository Owner

Repository Details

Programming Languages

Tags

Related MCPs