Time

What is Time?

Time is a Model Context Protocol (MCP) server that provides current time information and timezone conversion capabilities for large language models. It uses IANA timezone names and automatically detects the system timezone, enabling LLMs to answer time-related queries accurately.

How to use Time?

Install using uvx (recommended), pip, or Docker. Configure the server in your MCP client (e.g., Claude.app or Zed) by adding the appropriate command and arguments to the MCP settings. Once configured, LLMs can call two tools: get_current_time and convert_time.

Key features of Time

• Get current time in any IANA timezone or the system timezone
• Convert a time between two specified timezones
• Automatic system timezone detection with optional manual override
• Easy installation via uvx, pip, or Docker
• Responses include timezone, ISO datetime, and DST status

Use cases of Time

• Answer "What time is it now?" using the system timezone
• Provide current time in a specific city (e.g., "What time is it in Tokyo?")
• Convert a given time between two timezones (e.g., "When it's 4 PM in New York, what time is it in London?")
• Resolve meeting scheduling across different timezones

FAQ from Time

What tools does Time provide?

Time provides two tools: get_current_time (returns current time for a given IANA timezone) and convert_time (converts a time from one IANA timezone to another).

How do I install Time?

You can install via uvx (no explicit installation needed), pip install mcp-server-time, or Docker (mcp/time). Full configuration examples are provided for Claude.app and Zed.

Can I override the system timezone?

Yes, use the --local-timezone argument when starting the server (e.g., --local-timezone=America/New_York). Otherwise, the system timezone is detected automatically.

What arguments does convert_time require?

It requires three arguments: source_timezone (IANA name), time (24-hour format, HH:MM), and target_timezone (IANA name).

How can I debug Time?

Use the MCP inspector with npx @modelcontextprotocol/inspector uvx mcp-server-time. Detailed debugging steps are in the README.