home / mcp / time mcp server

Time MCP Server

Provides time and timezone conversion capabilities for MCP clients, including current time and cross-timezone conversions.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "carterpape-pape-mcp-server-time": {
      "command": "uvx",
      "args": [
        "pape-mcp-server-time"
      ]
    }
  }
}

Time MCP Server provides time and timezone conversion capabilities for MCP clients. It lets you retrieve the current time in a specified IANA timezone or in the system timezone, and convert times between timezones. This enables LLMs and other clients to obtain accurate temporal information and perform timezone calculations efficiently.

How to use

You interact with the Time MCP Server from your MCP client to fetch the current time or perform timezone conversions. Use the available tools by name and supply the required arguments as you would with other MCP tools.

Get the current time for a specific timezone or your system timezone. Provide the IANA timezone name to receive the current date and time including the offset and daylight saving status.

Convert time between timezones by specifying the source timezone, the time in 24-hour format, and the target timezone. You will receive both the source and target datetimes along with the time difference between zones.

How to install

Prerequisites: you need a Python environment or the uv runtime if you want to run the server via uvx.

Option A: run with uv (recommended) using the runtime wrapper uvx. No extra installation is required beyond having uvx available.

Option B: install with Python and run as a module.

Step-by-step commands you can use directly:

Configuration

Configure the Time MCP Server for different environments by specifying how you will launch it. The following are explicit configuration examples you can adapt.

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

If you prefer to run via Python after installation, use this configuration:

{
  "mcpServers": {
    "time": {
      "command": "python",
      "args": ["-m", "pape_mcp_server_time"]
    }
  }
}

To use the server under a different environment like Zed, add a similar entry to the Zed settings.json under context_servers.

<context_servers": {
  "pape-mcp-server-time": {
    "command": "uvx",
    "args": ["pape-mcp-server-time"]
  }
},

Customization and notes

By default, the server detects your system timezone automatically. You can override this behavior by passing a local timezone when starting the server.

{ "command": "python", "args": ["-m", "pape_mcp_server_time", "--local-timezone=America/New_York"] }

Tools and usage

The Time MCP Server exposes two tools you can call from an MCP client.

Available tools

get_current_time

Retrieve the current time for a specified IANA timezone or the system timezone. Provide timezone as an argument to receive the current datetime and DST status.

convert_time

Convert a given time from a source timezone to a target timezone. Provide source_timezone, time in HH:MM format, and target_timezone to obtain both datetimes and the time difference.