mcp-server-time

What it is and what it does

mcp-server-time is a Model Context Protocol server that bridges LLMs and time/timezone operations. It exposes two main tools: get_current_time retrieves the current moment in any IANA timezone (or the system timezone by default), and convert_time translates a given time from one timezone to another. The server runs as a subprocess and communicates with MCP-compatible clients like Claude, Zed, or VS Code, allowing language models to answer time-aware questions without hardcoding temporal logic.

The package depends on mcp (the protocol library), pydantic (for data validation), tzdata (IANA timezone database), and tzlocal (system timezone detection). It's designed to be lightweight and stateless—each query is independent. Configuration is straightforward: you point your client to run it as a command, optionally overriding the detected system timezone via a --local-timezone flag.

Use it for:

• Enable Claude or other LLMs to answer 'What time is it in Tokyo?' or similar queries accurately without hallucination.
• Convert meeting times across timezones within an AI assistant's response, e.g., 'When it's 4 PM in New York, what time is it in London?'
• Integrate time-aware scheduling or coordination into LLM-powered workflows that need to respect timezone differences.
• Provide real-time temporal context to LLMs in multi-timezone applications or global support systems.
• Debug or test LLM behavior around timezone-dependent logic by injecting accurate time data into the model's context.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Model Context Protocol server that gives LLMs access to current time queries and timezone conversions using IANA timezone names, with automatic system timezone detection.

Yes, if you are building an LLM application with Claude, Zed, or VS Code and need your model to reliably query or convert times. The package is actively maintained, has no security vulnerabilities, uses a permissive MIT license, and installs with minimal friction. It solves a real gap—LLMs cannot reliably reason about current time or timezone math without external tools. Install it only if you have an MCP-compatible client to configure it in; standalone it is not useful.

Install

mcp-server-time on PyPI

pip install mcp-server-time

uv add mcp-server-time

poetry add mcp-server-time

Installing mcp-server-time

Before you install

Low friction install with a pure Python wheel and four runtime dependencies. Active maintenance with recent commits and no known vulnerabilities.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.

Quickstart

pip install mcp-server-time
python -m mcp_server_time

# Or via uvx:
uvx mcp-server-time

# Then configure in Claude/Zed/VS Code to call get_current_time or convert_time tools

Requires Python 3.10 or later. Must be configured as an MCP server within a compatible client (Claude, Zed, VS Code, etc.) to be useful.

Verify before relying

• Whether the package works correctly with all IANA timezone names or has known edge cases.
• Performance characteristics when handling many concurrent timezone conversion requests.
• Exact behavior of DST transitions and whether is_dst flag is always accurate.

Package facts

Evidence: mcp_server_time-2026.7.10-py3-none-any.whl

Keywords: llm, mcp, time, timezone

Tags

More Application Frameworks packages