Time Mcp Server

lchinglen/time-mcp-server

Adds timezone awareness to Claude through two straightforward tools: get_current_time and convert_time. Both use IANA timezone names like America/New_York or Asia/Tokyo, so you can ask "what time is it in London" or "when it's 4 PM in New York, what time is it in Tokyo" and get back structured responses with datetime strings, DST flags, and time differences. The server auto-detects your system timezone but lets you override it with a flag. Useful when you're coordinating across regions, scheduling international meetings, or just need Claude to understand that 9 AM means different things in different places. Ships as a pip package or runs via uvx with minimal setup.

tools: 6
transport: STDIO
last updated: Feb 23, 2026

View on GitHub

Tools

6 tools

Public tool metadata for what this MCP can expose to an agent.

current_timeGet the current date and time.2 params

Get the current date and time.

Parameters* required

formatstring

The format of the time, default is empty stringone of h:mm A · h:mm:ss A · YYYY-MM-DD HH:mm:ss · YYYY-MM-DD · YYYY-MM · MM/DD/YYYYdefault: YYYY-MM-DD HH:mm:ss

timezonestring

The timezone of the time, IANA timezone name, e.g. Asia/Shanghai

relative_timeGet the relative time from now.1 params

Get the relative time from now.

Parameters* required

timestring

The time to get the relative time from now. Format: YYYY-MM-DD HH:mm:ss

days_in_monthGet the number of days in a month. If no date is provided, get the number of days in the current month.1 params

Get the number of days in a month. If no date is provided, get the number of days in the current month.

Parameters* required

datestring

The date to get the days in month. Format: YYYY-MM-DD

get_timestampGet the timestamp for the time.1 params

Get the timestamp for the time.

Parameters* required

timestring

The time to get the timestamp. Format: YYYY-MM-DD HH:mm:ss.SSS

convert_timeConvert time between timezones.3 params

Convert time between timezones.

Parameters* required

sourceTimezonestring

The source timezone. IANA timezone name, e.g. Asia/Shanghai

targetTimezonestring

The target timezone. IANA timezone name, e.g. Europe/London

timestring

Date and time in 24-hour format. e.g. 2025-03-23 12:30:00

get_week_yearGet the week and isoWeek of the year.1 params

Get the week and isoWeek of the year.

Parameters* required

datestring

The date to get the week and isoWeek of the year. e.g. 2025-03-23

Readme

Time MCP Server

A Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

Available Tools

get_current_time - Get current time in a specific timezone or system timezone.
- Required arguments:
  - timezone (string): IANA timezone name (e.g., 'America/New_York', 'Europe/London')
convert_time - Convert time between timezones.
- Required arguments:
  - source_timezone (string): Source IANA timezone name
  - time (string): Time in 24-hour format (HH:MM)
  - target_timezone (string): Target IANA timezone name

Installation

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-time.

uvx mcp-server-time

Using PIP

Alternatively you can install mcp-server-time via pip:

pip install mcp-server-time

View the full README on GitHub

Details

Repository: github.com/lchinglen/time-mcp-server
Package: lchinglen-time-mcp-server
Transport: STDIO
Registry: MCP registry, active