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
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
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:
2. convert_time
Convert time from one timezone to another.
Parameters:
sourceTimezone
(required): Source IANA timezone identifiertargetTimezone
(required): Target IANA timezone identifiertime
(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:
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 identifierincludeTime
(optional): Whether to include time information (default: false)
Example:
Development
Scripts
Project Structure
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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
A 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.
Related MCP Servers
- -securityFlicense-qualityAn MCP server providing timezone conversions and time-related operations via RESTful API endpoints, featuring comprehensive error handling and timezone database integration.Last updated -
- AsecurityAlicenseAqualityA TypeScript server implementing the Model Context Protocol (MCP) that provides datetime and timezone information to AI agents and chat interfaces, allowing them to access current time in various timezones.Last updated -4863Mozilla Public License 2.0
- -securityFlicense-qualityA simple Model Context Protocol (MCP) server that provides date and time functionality in any timezone, along with user profiles and personalized greeting resources.Last updated -