---
id: mcp-server-time
version: "2026.7.10"
license: MIT
license_treatment: permissive
maintenance: active
---

# mcp-server-time — A Model Context Protocol server providing tools for time queries and timezone conversions for LLMs

License: permissive · Maintenance: active · Downloads: 454.6K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 454.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mcp server time timezone, llm timezone conversion, model context protocol time tools, current time by timezone, iana timezone queries, mcp time server, llm time awareness, mcp-server, llm-integration, timezone-handling

[View on SkillFed](https://skillfed.io/packages/mcp-server-time) · [View on PyPI](https://pypi.org/project/mcp-server-time/)