time-mcp
A Claude Model Configuration Protocol (MCP) server that provides real-time timezone-aware date and time information.
Features
Get current time in any IANA timezone
Easy integration with Claude AI through MCP
Comprehensive timezone support using Python's zoneinfo module
Simple JSON responses in ISO format
Related MCP server: Date and Time MCP Server
Installation
# Clone the repository
git clone https://github.com/yourusername/time-mcp.git
cd time-mcp
# Set up virtual environment (using uv)
uv venv
source .venv/bin/activate
# Install the package
pip install -e .
Usage
Running the Server
python -m src.time_mcp.server
This starts the MCP server locally, making the time tool available to Claude.
Available Tools
get_current_time: Returns the current time in the specified timezoneParameter:
timezone(string) - Any valid IANA timezone (e.g., "America/New_York", "Europe/London", "Asia/Tokyo")Default: "UTC" if no timezone is specified
Development
# Run tests
pytest tests/
# Lint code
ruff check .
# Format code
ruff format .
Requirements
Python 3.10+
MCP library
License
MIT