---
title: "MCP time server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/mcp-server-time/
description: "Reads the local clock and converts a clock time between IANA zones using today’s date in the source zone."
---

# MCP time server: review, setup & limitations · Undominated.ai

> Reads the local clock and converts a clock time between IANA zones using today’s date in the source zone.

[← Explore all mcp servers](/mcp-servers/)

TIME / Model Context Protocol a Series of LF Projects, LLC

# MCP time server

Reads the local clock and converts a clock time between IANA zones using today’s date in the source zone.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/README.md)

SOURCE REVIEW

 Reviewed 2026-10-07
 Evidence 3 linked sources
 Publisher Model Context Protocol a Series of LF Projects, LLC
 Licence [MIT package metadata; Apache-2.0/MIT transition ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/LICENSE)
 Revision 5abed86c5317
 [Read what was—and wasn’t—checked ↓](#review)

“A Model Context Protocol server providing tools for time queries and timezone conversions for LLMs”

 [Model Context Protocol a Series of LF Projects, LLC · upstream description ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/pyproject.toml) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - The inspected handlers use the host clock and zone database and return MCP text; no credential or network time-service call appears in these handlers.
- The small tool surface separates current-time lookup from a clock conversion and returns source/target offsets and DST indicators.

### A good fit for

 - Current-time lookup backed by the host clock
- Simple same-day clock conversion with explicit IANA zone names

### Weigh up before choosing

 - convert_time has no date argument: it assigns the supplied clock to today in the source zone. It is not a future-date scheduling or historical-conversion tool.
- The handler attaches ZoneInfo directly without a fold choice or a check for ambiguous/nonexistent local wall times. Daylight-saving transition edge cases are not validated by this review.
- Both tools advertise readOnlyHint, which is metadata rather than a sandbox. A current-time result changes with the host clock even though the source also sets idempotentHint.
- The helper constructs an invalid-params exception for an invalid zone, but the dispatch handler catches all exceptions and rethrows ValueError. A specific protocol error code is not established.
- The README conversion example is internally inconsistent; source behavior, rather than that example, grounds this entry. Docker setup and dependency/runtime behavior were not tested.
- The uvx command resolves a registry package and does not bind its bytes to the reviewed repository commit. No package installation or tool execution was performed.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - src/time/src/mcp_server_time/server.py
- src/time/src/mcp_server_time/__init__.py
- src/time/src/mcp_server_time/__main__.py
- src/time/pyproject.toml
- src/time/README.md
- LICENSE

### Our findings

 - The complete implementation and entrypoints were read, along with package metadata, README and the complete root licence.
- Package metadata and README declare MIT; the root licence explains an Apache-2.0 transition with remaining MIT contributions and separate CC-BY-4.0 documentation terms. This entry does not describe the whole repository as solely MIT.
- get_current_time requires an explicit timezone argument. --local-timezone changes the suggested local zone in tool descriptions; it does not make the required argument optional.
- The outer call_tool exception handler wraps the invalid-zone exception as ValueError; the earlier metadata claim of an invalid-params protocol response was removed.

### Not established by this review

 - The server was not started.
- No timezone conversion was executed.
- src/time/Dockerfile, the test file, and uv.lock were not opened.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/README.md)

DOCUMENTED COMMAND

 uvx mcp-server-time Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Install uv and provide a supported Python3.10+ interpreter.
- Register uvx with argument mcp-server-time as the stdio command in your MCP client.
- Supply explicit IANA zone names to the tools. The optional --local-timezone argument changes the host-local suggestion.
- Record and review the resolved package version before use; the unversioned registry launch was not executed or hash-bound to this source revision.

### Before you start

 - uv and Python3.10 or later
- An MCP client supporting stdio
- Host clock and IANA timezone data; dependency installation may require network access

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "command": "uvx",
 "args": [
 "mcp-server-time"
 ]
} Copy configuration ↗

### Compatibility

An MCP client that speaks stdio · Python 3.10 or later

### Implementation

Python

### Transports

stdio

### Local stdio process; host clock and timezone data

 - Read host clock and IANA timezone data.
- Communicate with the MCP client over stdio.
- The reviewed tool handlers contain no application file-write or network-service calls; package acquisition and dependencies are outside that statement.

### Cost model

Local open-source package; its metadata declares MIT while the repository records an Apache-2.0/MIT transition. Host, client and package-distribution services retain their own terms.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [MCP time server ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/src/mcp_server_time/server.py) Checked 2026-10-07 https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/src/mcp_server_time/server.py Supports: summary, whySelected, tool handlers
- [Time server README ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/README.md) Checked 2026-10-07 https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/README.md Supports: documented tools, install text that was not executed, sample response that disagrees with the handler
- [MIT licence text ↗](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/LICENSE) Checked 2026-10-07 https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/LICENSE Supports: MIT terms, Copyright (c) 2024-2025 Model Context Protocol a Series of LF Projects, LLC

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### AWS Labs Amazon Translate ↗ Translates text and manages document translation jobs and custom terminology with AWS Translate.](/mcp-servers/awslabs-translate/)[### AWS Labs Finch ↗ Builds and pushes container images through the local Finch CLI, with additional ECR repository support.](/mcp-servers/awslabs-finch/)[### AWS Labs HealthImaging ↗ Searches and manages medical imaging datastores, image sets and DICOM lifecycle operations.](/mcp-servers/awslabs-healthimaging/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
