Time

Time MCP Server provides time and timezone conversion capabilities to assist LLMs with current time information and timezone calculations. By exposing tools to fetch the current time in a specified timezone and to convert times across timezones, you can embed accurate temporal logic and scheduling in your applications and prompts.

How to use

You interact with Time MCP Server through an MCP client to perform two main tasks: get the current time in a specific timezone and convert a time between timezones. You can query the server by selecting the desired tool and supplying the required arguments. Use the get_current_time tool to retrieve the current time for a given IANA timezone name, or use convert_time to translate a time from one timezone to another. The server automatically detects the system timezone unless you override it with a local timezone option. When you need precise cross-timezone results, ensure you provide valid IANA timezone names such as America/New_York, Europe/London, or Asia/Tokyo.

How to install

Prerequisites you need before running the Time MCP Server:
- Python (for the pip installation and running the module)
- Access to run commands in your environment (shell/terminal)
- Optional: Docker if you prefer running the server via Docker
- Optional: uvx if you want to run the server through the uvx launcher
Follow the step-by-step options below to choose your preferred installation method.

Configure for Claude.app

Choose one of the following runtime methods to start the server for Claude.app.

Using uvx

To run Time MCP Server with uvx for Claude.app, configure your MCP server entry as shown.

Using docker

If you prefer running Time MCP Server via Docker, use the following MCP server configuration.

Using pip installation

Install the server with pip and run it as a module to expose the MCP endpoint.

Configure for Zed

Integrate Time MCP Server with Zed by adding an MCP server entry that points to the appropriate runtime.

Using uvx

In Zed settings, register the MCP server with uvx as shown.

Using pip installation

If you installed via pip, add the server reference in Zed’s context servers accordingly.

Customization - System Timezone

By default, Time MCP Server auto-detects your system timezone. You can override this by adding the argument --local-timezone to the command arguments. Example: python -m mcp_server_time --local-timezone=America/New_York.

Example interactions

Get current time example: request the current time for Europe/Warsaw and receive the timestamp and timezone offset in the response.

Debugging

If you need to inspect the MCP communication, use the MCP inspector tool with the appropriate runtime. For uvx installations you can run: npx @modelcontextprotocol/inspector uvx mcp-server-time.

Build

If you are building a Docker image for the Time MCP Server, navigate to the build context and run the image build command shown in your setup. Example: cd src/time then docker build -t mcp/time ..

Contributing

Contributions are welcome. You can add new time-related tools, improve handling of timezones, or enhance documentation to help others use Time MCP Server more effectively.

License

Time MCP Server is licensed under the MIT License. This allows you to use, modify, and distribute the software in compliance with the license terms.

Available tools

get_current_time

Get the current time in a specific timezone. Requires a timezone argument with a valid IANA timezone name.

convert_time

Convert a time from one IANA timezone to another. Requires source_timezone, time (HH:MM), and target_timezone.