Log inSubmit server
Time logo

Time

Get current time and convert clock times across IANA timezones through two MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget

Install Time

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": [
        "mcp-server-time"
      ],
      "env": {
        "LOCAL_TIMEZONE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

Time MCP server provides current-time lookup and timezone conversion through the Model Context Protocol over stdio. Its tools use exact IANA timezone names and can detect the host system timezone or use an explicitly configured local timezone. Install it with uvx, pip, or Docker when an agent needs reliable time calculations without an external service. Responses include ISO datetimes, weekday information, daylight-saving status, and conversion offsets.

Use cases

  • Check the current time in a named timezone
  • Convert a meeting time between regions
  • Compare working hours across offices
  • Determine whether a timezone is observing daylight saving time

Key features

  • Current-time lookup by IANA timezone
  • Timezone conversion for 24-hour clock times
  • Automatic system timezone detection
  • Optional local timezone override
  • Structured and text-formatted tool results
  • Docker, uvx, and pip launch options

Tools2

What Time lets your agent do. Expand a tool for its parameters.

Verified live~264 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

47/47 checks healthy over the last 89d

What it can do

From the 2 tools this server returned when we ran it; 2 declare their own safety hints.

Read-only tools · 2
Network at startup2 connections
Files written at startup10

Observed 2026-10-23 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · mcp-server-time (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars91kStargazers on the source repository.
Last commit1d agoMost recent push to the default branch.
Tools exposed2Callable tools this server registers over MCP.
Directory activity11 viewsConfig copies, upvotes, and views on AllMCPs.

How Time works

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:

Terminal
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.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Time

Time is an MCP server that reads system or IANA timezone information and exposes get_current_time for current local time plus convert_time for cross-zone conversion. It runs over stdio and supports uvx, pip, and Docker installation, with optional local timezone configuration.

Install it with uvx or pip. Run `uvx mcp-server-time` directly, or use `pip install mcp-server-time` followed by `python -m mcp_server_time`. Docker configuration is also available for MCP clients that launch containerized servers.

Time requires exact, case-sensitive IANA timezone names such as `Europe/London` or `America/New_York`. Lowercase or otherwise incorrect spellings are rejected, including on platforms with case-insensitive filesystems.

Set it with the `--local-timezone` argument, such as `--local-timezone=America/New_York`. Docker users can set `LOCAL_TIMEZONE`; if that variable is empty or unset in Docker, the server uses UTC.

Yes. Time includes stdio configuration examples for Claude, Zed, and VS Code. It can be launched with `uvx mcp-server-time`, `python -m mcp_server_time`, or Docker depending on the client configuration.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTime AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/time?style=directory)](https://allmcps.com/mcp/time)
HTML Embed
<a href="https://allmcps.com/mcp/time"><img src="https://allmcps.com/api/badge/time?style=directory" alt="Time on AllMCPs" /></a>