time MCP Server

Use This MCP server To

Retrieve current UTC and local time for time-sensitive responses Calculate relative time intervals for scheduling or reminders Generate precise timestamps for logging or event tracking Determine the number of days in any given month Convert time between different formats or time zones

README

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

time-mcp FAQ

How does the Time MCP Server provide time awareness to LLMs?

It exposes structured time data and tools like current time, relative time, and timestamp generation to LLMs via the MCP protocol.

Can the Time MCP Server handle different time zones?

Yes, it provides local time as well as UTC time, enabling LLMs to work with multiple time zones.

Is the Time MCP Server compatible with multiple LLM providers?

Yes, it is provider-agnostic and works with OpenAI, Claude, Gemini, and other LLMs supporting MCP.

What time-related operations can LLMs perform using this server?

LLMs can get current time, calculate relative times, convert time formats, get timestamps, and find days in a month.

How do I integrate the Time MCP Server into my MCP client?

You can connect it as a standard MCP server endpoint exposing its time-related tools and data for your client to consume.

Does the Time MCP Server support daylight saving time adjustments?

Yes, it provides accurate local time that accounts for daylight saving changes where applicable.

Is the Time MCP Server open source and actively maintained?

Yes, it is open source under the MIT license and available on GitHub with community support.

Can the Time MCP Server be extended with custom time functions?

Yes, developers can extend or customize the server to add additional time-related capabilities as needed.