Time

What it is

Time MCP Server is a Model Context Protocol server that provides time and timezone conversion capabilities. It lets LLMs get current time information and convert times between timezones using IANA timezone names. By default it detects the system timezone automatically, and this can be overridden with a --local-timezone argument.

Who it's for

• Users of MCP clients such as Claude.app, Zed, VS Code or Zencoder who want their LLM to answer time and timezone questions
• Developers who need time conversion between IANA timezones exposed as MCP tools

Requirements

Setup

1. Run with uvx (recommended)

   With uv installed, no specific installation is needed; uvx runs mcp-server-time directly.

   bashCopy

   uvx mcp-server-time

2. Or install with pip

   Install the package via pip.

   bashCopy

   pip install mcp-server-time

3. Run the pip-installed module

   After installation, run it as a script.

   bashCopy

   python -m mcp_server_time

4. Configure Claude.app (uvx)

   Add this to your Claude settings.

   jsonCopy

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

5. Override the system timezone (optional)

   Add the --local-timezone argument to the args list in the configuration.

   jsonCopy

   {
     "command": "python",
     "args": ["-m", "mcp_server_time", "--local-timezone=America/New_York"]
   }

Examples

{
  "name": "get_current_time",
  "arguments": {
    "timezone": "Europe/Warsaw"
  }
}

{
  "name": "convert_time",
  "arguments": {
    "source_timezone": "America/New_York",
    "time": "16:30",
    "target_timezone": "Asia/Tokyo"
  }
}

What time is it in Tokyo?

When it's 4 PM in New York, what time is it in London?

npx @modelcontextprotocol/inspector uvx mcp-server-time

Pros & cons

Images