time-mcp

An MCP server that returns the local current time and the current time in any IANA timezone.

日本語はこちら(README-ja.md)

Tools

The time object returned by the tools above:

get_time_from_ntp adds two fields: ntp_server (the host actually used) and local_clock_offset_seconds (how far the machine's clock is from the NTP time; positive means the local clock is behind).

NTP servers

server takes one of these short names, or any NTP hostname.

When server is omitted, time.apple.com is tried first and time.windows.com is used as a fallback. Requires outbound UDP port 123; the timeout is 5 seconds.

Install

pip install time-mcp

Or run it without installing:

uvx time-mcp

Development setup

uv sync

Try it

uv run mcp dev src/time_mcp/server.py

Register with Claude Code

claude mcp add time -- uvx time-mcp

Or in claude_desktop_config.json:

{
  "mcpServers": {
    "time": {
      "command": "uvx",
      "args": ["time-mcp"]
    }
  }
}

Register with Codex CLI

codex mcp add time -- uvx time-mcp

Or add it to ~/.codex/config.toml by hand:

[mcp_servers.time]
command = "uvx"
args = ["time-mcp"]

Check that it is registered:

codex mcp list

Running from a local checkout

Replace uvx time-mcp with the following in any of the configurations above:

uv --directory /path/to/mcp_server-time run time-mcp

License

MIT License. See LICENSE.