MCP time (reference)

Time MCP Server

A Model Context Protocol server that provides time and timezone conversion capabilities. This server enables LLMs to get current time information and perform timezone conversions using IANA timezone names, with automatic system timezone detection.

Source: https://github.com/modelcontextprotocol/servers/tree/main/src/time

Requires MCP Python SDK 1.x (mcp>=1.29.0,<2). SDK 2.0 renamed APIs this server uses. The port to v2 is in progress.

Available Tools

• get_current_time - Get current time in a specific timezone or system timezone.

  • Required arguments:
    • timezone (string): IANA timezone name (e.g., 'America/New_York', 'Europe/London')

• convert_time - Convert time between timezones.

  • Required arguments:
    • source_timezone (string): Source IANA timezone name
    • time (string): Time in 24-hour format (HH:MM)
    • target_timezone (string): Target IANA timezone name

A timezone name, here and in --local-timezone, must be an exact IANA key, case included: Europe/Warsaw is accepted and europe/warsaw is rejected on every platform, including macOS, whose case-insensitive filesystem would otherwise resolve it.

Installation

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-time.

uvx mcp-server-time

Using PIP

Alternatively you can install mcp-server-time via pip:

pip install mcp-server-time

After installation, you can run it as a script using:

python -m mcp_server_time

Configuration

Configure for Claude.app

Add to your Claude settings:

<details> <summary>Using uvx</summary>

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

</details>

<details> <summary>Using docker</summary>

{
  "mcpServers": {
    "time": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "LOCAL_TIMEZONE", "mcp/time"]
    }
  }
}

</details>

<details> <summary>Using pip installation</summary>

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

</details>

Configure for Zed