Time MCP Server logo

Time MCP Server

by modelcontextprotocol

The Time MCP Server provides time and timezone conversion capabilities for LLMs. It allows getting current time information and performing timezone conversions using IANA timezone names.

View on GitHub

Last updated: N/A

What is Time MCP Server?

The Time MCP Server is a Model Context Protocol server designed to provide accurate time and timezone information to Large Language Models (LLMs). It enables LLMs to understand and respond to time-related queries, perform timezone conversions, and access current time data.

How to use Time MCP Server?

The server can be installed using uv or pip. Once installed, it can be configured for use with applications like Claude and Zed by adding the server's command and arguments to their respective settings. The server exposes two tools: get_current_time and convert_time, which can be called with appropriate arguments (timezone, source_timezone, time, target_timezone) to retrieve time information or perform conversions.

Key features of Time MCP Server

  • Provides current time in specified timezones

  • Converts time between different timezones

  • Uses IANA timezone names for accuracy

  • Automatic system timezone detection

  • Easy integration with LLM platforms

  • Customizable system timezone

Use cases of Time MCP Server

  • Answering questions about the current time in different locations

  • Scheduling events across multiple timezones

  • Converting times for international communication

  • Providing context for time-sensitive information

  • Building applications that require accurate time data

FAQ from Time MCP Server

How do I specify a timezone?

Use the IANA timezone name (e.g., 'America/New_York').

Can I use my system's timezone?

Yes, the server automatically detects your system's timezone. You can also override this with the --local-timezone argument.

What time format should I use for time conversions?

Use the 24-hour format (HH:MM).

How do I configure the server for Claude?

Add the server configuration to your Claude settings under the mcpServers section, specifying the command and arguments.

How do I debug the server?

Use the MCP inspector with uvx mcp-server-time or uv run mcp-server-time depending on your installation method.