Time MCP Server: Giving LLMs Time Awareness Capabilities

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

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 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.