Time (Reference) — Claude Code MCP server
Time (Reference) is an MCP server for Claude Code that gives agents access to current time and time zone conversion. It supports tasks involving multiple time zones and schedules.
no license ★ 92,149 updated 2026-10-25
Open on GitHubWhat Time (Reference) does
The server exposes two tools: fetch current time in a specific timezone and convert time between zones. Both use IANA timezone names like America/New_York or Europe/London. It auto-detects your system timezone but accepts --local-timezone to override it.
Requires Python and MCP Python SDK 2.x (mcp>=2.3,<3). The server handles both protocol versions at once and picks the right one based on the client's first request. Tools return results as structured data and also as indented JSON text for clients that don't parse structured output.
Errors—invalid timezone, malformed time, missing args—come back as error results the model can read and act on. Timezone names are case-sensitive across all platforms: Europe/Warsaw works, europe/warsaw does not.
What it helps with
- fetch current time in a specific timezone
- convert time between timezones
- keep agent actions in sync across multiple regions
- handle timezone mismatches in multi-region projects
Example prompts for the agent
- What time is it in New York right now?
- Convert 14:30 from Tokyo to Moscow time
- What's the time in London when it's 9 AM for me?
How to install Time (Reference)
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Time (Reference)
How do I install Time (Reference) for Claude Code?
Add it to your Claude config: "mcpServers": { "time": { "command": "uvx", "args": ["mcp-server-time"] } }. Or install via pip: pip install mcp-server-time, then run python -m mcp_server_time. You need Python and MCP SDK 2.x installed first.
What does Time (Reference) do?
It gives the agent two tools: get_current_time to fetch time in any IANA timezone, and convert_time to shift time between zones. The server detects your local timezone automatically unless you specify a different one.
Why doesn't my timezone name work?
Timezone names are case-sensitive and must match IANA exactly: Europe/Warsaw, not europe/warsaw. Use standard IANA keys like America/Los_Angeles, Asia/Tokyo, or UTC.