# Time [Verified] [Health: Active]

**Category:** 🛠️ Other Tools and Integrations  
**Repository:** https://github.com/modelcontextprotocol/servers/tree/main/src/time  
**GitHub Stars:** 91819  
**Views:** 11  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/time

## Description
Time and timezone conversion capabilities.

## Tools
Capabilities this server exposes over MCP:

- **get_current_time** — Get current time in a specific timezone
- **convert_time** — Convert time between timezones

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "time": {
    "command": "uvx",
    "args": ["mcp-server-time"],
    "env": {
      "LOCAL_TIMEZONE": ""
    }
  }
}
```

**Requires environment variables:** `LOCAL_TIMEZONE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Time MCP server does

Time MCP server gives MCP-compatible agents two focused tools for timezone-aware time operations:

- `get_current_time` returns the current time for a specified IANA timezone, or for the configured system timezone when no explicit zone is used.
- `convert_time` translates a 24-hour clock time from one IANA timezone to another.

Results include timezone-aware ISO datetimes. Current-time results also report the weekday and whether daylight saving time is active. Conversion results include source and target details plus the time difference between the zones.

Reach for this server when an agent needs to answer questions such as the current time in another city, compare working hours, or translate a scheduled time between regions.

## How it works

The server communicates over stdio and supports both the 2026-07-28 and 2025-11-25 MCP protocol handshakes. The client's first request determines which protocol flow is used, while the available tools behave the same way in either case.

Timezone arguments must be exact, case-sensitive IANA keys such as `Europe/Warsaw`, `America/New_York`, or `Asia/Tokyo`. The server can identify the host timezone automatically for local-time requests. A configured `--local-timezone` value overrides that detection. Docker containers use `UTC` when `LOCAL_TIMEZONE` is unset or empty.

Each tool declares an output schema and returns the result both as structured MCP content and as formatted JSON text. Invalid or incomplete tool arguments produce an `isError` result that the model can read. Errors include unknown timezones, incorrectly formatted times, missing arguments, and wall-clock times skipped by a clock change. Unknown tool names return a JSON-RPC `-32602` error. The server registers no prompts or resources.

## Setup and configuration

The recommended launch method uses `uvx` and requires no separate package installation:

```bash
uvx mcp-server-time
```

You can also install the package with pip and run it as a Python module:

```bash
pip install mcp-server-time
python -m mcp_server_time
```

The package requires MCP Python SDK 2.x, within the `mcp>=2.3,<3` range. MCP clients can launch the stdio process with either `uvx mcp-server-time` or `python -m mcp_server_time`.

To choose the local timezone explicitly, add an argument such as:

```bash
python -m mcp_server_time --local-timezone=America/New_York
```

For Docker, pass `LOCAL_TIMEZONE` with `-e`, for example `-e LOCAL_TIMEZONE=America/New_York`. A `--local-timezone` argument supplied after the image name takes precedence. The server includes configuration examples for Claude, Zed, and VS Code, and can be inspected during development with the MCP Inspector.

## Tools and capabilities

### `get_current_time`

Accepts a required `timezone` string containing an exact IANA timezone name. The response provides the timezone, current datetime, weekday, and daylight-saving indicator.

### `convert_time`

Accepts `source_timezone`, `time`, and `target_timezone`. The `time` value must use 24-hour `HH:MM` notation. The response contains source and target datetimes, their weekdays, daylight-saving indicators, and the time difference.

Both tools return structured output and a text representation of the same result, which accommodates clients that do not consume structured MCP content.

## Limitations and notes

This server performs timezone operations locally through the Python MCP implementation; it does not provide calendar scheduling or reminders. Timezone identifiers are case-sensitive on every platform, so `europe/warsaw` is rejected even where the operating system filesystem is case-insensitive. A local time that falls into a gap created by a clock change is rejected rather than converted.

The server is stdio-based. Docker cannot automatically see the host timezone, so its local setting must be passed explicitly or it falls back to UTC. No prompts or resources are exposed.

_Full upstream README: https://allmcps.com/mcp/time/readme_