mcpField
🚀
🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

Local
github.com/yokingmaProductivity72Updated 39w ago
Repository

About 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

Time MCP Server is an MCP server that gives LLMs time awareness. It provides tools for current time, timezone conversion, relative time and calendar information, for users who need assistants to handle dates and times accurately.

Key features

  1. 01Get current time in UTC and local time
  2. 02Convert times between timezones
  3. 03Get relative time and timestamps
  4. 04Get number of days in a month
  5. 05Get week and ISO week of the year

Use cases

  1. 01Answering current time or date questions in an AI assistant
  2. 02Converting meeting times across timezones
  3. 03Looking up days in a month or week numbers in a year

MCP support

This is an MCP server that exposes current_time, relative_time, get_timestamp, days_in_month, convert_time and get_week_year tools to MCP clients.

#agents#llm#mcp-server#time-mcp

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "time": {
      "command": "npx",
      "args": [
        "-y",
        "time-mcp"
      ]
    }
  }
}
Run commandnpx -y time-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtime-mcp1.0.6

Tools

6

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
formatenumNoThe format of the timeh:mm A | h:mm:ss A | YYYY-MM-DD HH:mm:ss | YYYY-MM-DD | YYYY-MM | MM/DD/YYYY | MM/DD/YY | YYYY/MM/DD | YYYY/MM
timezonestringNoThe timezone of the time, IANA timezone name, e.g. Asia/Shanghai

Details

From the project README

🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities

smithery badge Github Stars License Report a bug

A Model Context Protocol (MCP) server implementation that allows LLMs to have time awareness capabilities.

README image

Tools

  • current_time: Get current time (UTC and local time)
  • relative_time: Get relative time
  • get_timestamp: Get timestamp for the time
  • days_in_month: Get days in month
  • convert_time: Convert time between timezones
  • get_week_year: Get week and isoWeek of the year

Installation

Installing via Smithery

To install time-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @yokingma/time-mcp --client claude
Manually install (Optional)
npm install -g time-mcp
using npx
npx -y time-mcp

Running on Claude Code

To add time-mcp to Claude Code, use the following command:

claude mcp add time-mcp -- npx -y time-mcp

To verify the installation:

claude mcp list

You should see time-mcp listed with a ✓ Connected status.

Usage in Claude Code

Once installed, you can use time-mcp tools in your conversations with Claude Code. For example:

  • "What time is it now?"
  • "Convert 2:00 PM from New York to Tokyo time"
  • "How many days are in this month?"
  • "What week of the year is it?"

The time-mcp server will automatically provide accurate time information to Claude.

Running on Cursor

Your mcp.json file will look like this:

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

Running on Windsurf

Add this to your ./codeium/windsurf/model_config.json file:

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

License

MIT License - see LICENSE file for details.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.