Time MCP Server

What is Time MCP Server?

Time MCP Server is a Model Context Protocol server that provides current time retrieval and timezone conversion using IANA timezone names, with automatic system timezone detection. It is designed for LLMs that need to answer time-related questions accurately.

How to use Time MCP Server?

Install via pip install mcp-server-time or use uvx mcp-server-time directly. Configure in Claude.app or Zed by adding the server to mcpServers with the appropriate command (uvx, Docker, or python -m). Use the tools get_current_time and convert_time with required IANA timezone arguments.

Key features of Time MCP Server

• Get current time in any IANA timezone
• Convert time between two timezones with DST detection
• Automatic system timezone detection
• Multiple deployment options: uvx, pip, Docker
• Configurable local timezone override
• Returns formatted datetime with timezone offset

Use cases of Time MCP Server

• Ask “What time is it in Tokyo?” and receive the current local time
• Convert a specific time from one timezone to another, e.g., “4 PM New York to London”
• Get the system’s current time when no timezone is specified
• Plan international meetings by calculating time differences and DST status
• Programmatically check timezone offsets for scheduling or logging

FAQ from Time MCP Server

What tools does Time MCP Server provide?

It provides get_current_time to fetch the current time in a given timezone, and convert_time to convert a time between two timezones. Both require IANA timezone names as arguments.

How do I install Time MCP Server?

Install via pip (pip install mcp-server-time), or use uvx mcp-server-time without installation. Docker is also supported: docker run -i --rm mcp/time.

How do I configure Time MCP Server for Claude?

Add the server to your mcpServers with the command uvx mcp-server-time, docker run -i --rm mcp/time, or python -m mcp_server_time, depending on your preferred method.

Can I override the system timezone?

Yes, use the --local-timezone argument when starting the server, e.g., --local-timezone=America/New_York.

What timezone format is required?

All timezone arguments must be valid IANA timezone names, such as America/New_York or Europe/London.