Time

⏰ Time MCP Server: Giving LLMs Time Awareness Capabilities

javascript

59

GitHub Stars

javascript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

This Time MCP Server enables time awareness for language models by exposing practical time-related tools that you can call from your MCP client. It lets you retrieve the current time, convert between time zones, compute relative times, and perform common calendar calculations, all in a lightweight MCP server that integrates with your conversational workflows.

How to use

You interact with the Time MCP Server through an MCP client by invoking its time tools as you would with any other MCP endpoint. The server provides practical time utilities that you can request during conversations, such as asking for the current time, converting time between zones, calculating days in a month, or identifying the week of the year. Use these tools to keep your assistant contextually aware of time and to perform time-based calculations on demand.

How to install

Prerequisites: you should have Node.js installed on your machine. If you do not have Node.js, install it from the official Node.js site or using your preferred package manager.

Install Time MCP Server globally using npm or run it directly with npx.

Run Time MCP Server locally with npx to start serving time tools.

Here are concrete commands to set up and run the server:

# Install Time MCP Server globally (optional)
npm install -g time-mcp

# Run the server directly with npx
npx -y time-mcp

# If you are using this inside an MCP client workflow, you can add Time MCP to your client configuration as shown below.

MCP configuration for clients

To enable Time MCP Server in your MCP client, reference the following local runtime configuration. This example shows how to launch the server as an integrated MCP source within your client setup.

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

Available tools

current_time

Retrieve the current UTC and local time for any moment you request.

relative_time

Compute a relative time span, such as minutes or days between two moments.

get_timestamp

Obtain a timestamp for a given moment in time.

days_in_month

Return the number of days in a specified month and year.

convert_time

Convert a time value from one timezone to another.

get_week_year

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