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.
“A Model Context Protocol server providing tools for time queries and timezone conversions for LLMs”
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.
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.
DOCUMENTED COMMAND
uvx mcp-server-time 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"
]
} 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 ↗Checked
https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/time/src/mcp_server_time/server.py
Supports: summary, whySelected, tool handlers
- Time server README ↗Checked
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 ↗Checked
https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/LICENSE
Supports: MIT terms, Copyright (c) 2024-2025 Model Context Protocol a Series of LF Projects, LLC