Time

Developer tools Schedule management .Python

rating : 2.5 points

downloads : 14

update time : 2025-04-29

What is the Time MCP Server?

The Time MCP Server is a server dedicated to handling time and time zone-related operations. It can help you obtain the current time around the world and convert time between different time zones. The server uses the standard IANA time zone database to ensure the accuracy of time zone information.

How to use the Time MCP Server?

You can interact with the server through simple JSON commands to obtain the current time or perform time zone conversion. The server can be integrated into applications such as Claude.app or Zed, or used directly through the command line.

Applicable scenarios

Suitable for scenarios that require cross-time zone collaboration, scheduling international meetings, developing time-sensitive applications, or any scenario that requires accurate time information.

Main features

Get the current timeGet the current accurate time, including date, time, and time zone offset information, based on the specified time zone or the system time zone

Time zone time conversionConvert time between different time zones and automatically handle daylight saving time (DST) changes

Automatic time zone detectionAutomatically detect the time zone where the system is located without manual configuration

Advantages and limitations

Advantages

Use the standard IANA time zone database to ensure the accuracy of global time zones

Automatically handle daylight saving time changes without manual adjustment

Lightweight design with fast response

Support multiple installation methods, including uv, pip, and docker

Limitations

Need to be connected to the Internet to obtain the latest time zone rule updates

Only support the 24-hour time format

Time zone conversion does not include date information, which may cause confusion in cross-day conversions

How to use

Install the server

Choose the installation method that suits you: use uv (recommended), pip, or docker

Configure the client application

Add the server configuration to applications such as Claude.app or Zed

Start using

Interact with the server by sending JSON commands to obtain time information or perform time zone conversion

🚀 Time MCP Server

A Model Context Protocol (MCP) server that provides time and timezone conversion functions. This server enables Large Language Models (LLMs) to obtain current time information, perform timezone conversions using IANA timezone names, and supports automatic detection of the system timezone.

🚀 Quick Start

The Time MCP Server allows LLMs to handle time and timezone-related tasks. It offers tools for getting the current time and converting time between different timezones.

✨ Features

Available Tools

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

📦 Installation

Using uv (Recommended)

When using uv, no specific installation is required. We'll directly use uvx to run mcp-server-time.

Using PIP

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

pip install mcp-server-time

After installation, you can run it as a script:

python -m mcp_server_time

📚 Documentation

Configuration

Configuration for Claude.app

Add the following to your Claude settings:

Using uvx

```json "mcpServers": { "time": { "command": "uvx", "args": ["mcp-server-time"] } } ```

Using docker

```json "mcpServers": { "time": { "command": "docker", "args": ["run", "mcp/time"] } } ```

Configuration for Local Development

Add the following to ~/.config/uv/servers.json:

{
  "servers": {
    "time": {
      "implementation": "local",
      "command": "node",
      "args": ["src/time/index.js"]
    }
  }
}

Example Questions

"What's the current time?" (Will use the system timezone)
"What time is it in Tokyo?"
"When it's 4 PM in New York, what time is it in London?"
"Convert 9:30 AM in Tokyo to New York time"

Development Build

Docker build:

cd src/time
docker build -t mcp/time .

🤝 Contribution

We welcome any contributions to help expand and improve mcp-server-time. Whether it's adding new time-related tools, enhancing existing features, or improving the documentation, your input is valuable.

For examples of other MCP servers and implementation patterns, see: https://github.com/modelcontextprotocol/servers

Pull Requests are welcome! Feel free to contribute new ideas, bug fixes, or enhancements to mcp-server-time to make it more powerful and useful.

📄 License

mcp-server-time is licensed under the MIT License. This means you're free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, see the LICENSE file in the project repository.