Time

GitHub
Integrates with
Claude AI

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

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 timezone
    • Parameter: 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