home / mcp / time mcp server

Time MCP Server

Provides time-awareness capabilities to LLMs by exposing time utilities via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ampcome-mcps-time-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "time-mcp"
      ]
    }
  }
}

Time MCP Server enables LLMs to operate with time awareness by exposing a set of time utilities that you can call from your MCP client. This makes it easy to fetch current times, perform timezone conversions, derive relative time information, and more, all in a standardized MCP interface.

How to use

You use Time MCP Server by connecting your MCP client to the local or remote MCP endpoint that runs the server. Once connected, you can invoke the included tools to retrieve time data or perform time calculations. Practical patterns include requesting the current time in UTC or local time, converting between timezones, computing the number of days in a given month, and obtaining week-based year information.

How to install

Prerequisites you need before installing Time MCP Server: Node.js and npm (or npx available). You will also need a command-line environment where you can run npm and npx commands.

Option A — Install via a client command (recommended if you want automatic setup):

npx -y @smithery/cli install @yokingma/time-mcp --client claude

Option B — Manual installation (global):

npm install -g time-mcp

Option C — Run directly with npx (no install needed):

npx -y time-mcp

Configuration and runtime notes

When you run Time MCP Server locally, you configure how the server is loaded by your MCP client. A typical configuration in your client looks like the following, where the server is started via npx time-mcp.

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

Available tools

current_time

Get current time in UTC and local time.

relative_time

Get a human-friendly relative time string.

get_timestamp

Fetch a timestamp for the current or provided time.

days_in_month

Return the number of days in a specified month.

convert_time

Convert a time value between timezones.

get_week_year

Return the week number and ISO week-year for a given date.