Skip to main content
Glama
Time MCP Server

Time MCP Server

by ampcome-mcps

🚀 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

Related MCP server: Time MCP Server

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.

Available Tools

6 tools
convert_timeB

Convert time between timezones.

Inputs: sourceTimezone (required), targetTimezone (required), time (required).

current_timeB

Get the current date and time.

Inputs: format (required), timezone.

days_in_monthA

Get the number of days in a month. If no date is provided, get the number of days in the current month.

Inputs: date.

get_timestampC

Get the timestamp for the time.

Inputs: time.

get_week_yearC

Get the week and isoWeek of the year.

Inputs: date.

relative_timeB

Get the relative time from now.

Inputs: time (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as time conversion, current time retrieval, and timestamp generation. However, 'get_week_year' and 'relative_time' could be slightly ambiguous in scope, as both relate to temporal positioning, but their descriptions clarify the differences well.

    Naming Consistency4/5

    The tools follow a consistent verb_noun pattern (e.g., convert_time, current_time) with clear, descriptive names. There are minor deviations like 'days_in_month' using plural form, but overall, the naming is highly readable and predictable.

    Tool Count5/5

    With 6 tools, the server is well-scoped for time-related operations, covering core functionalities like conversion, current time, and date calculations. Each tool earns its place without feeling excessive or insufficient for the domain.

    Completeness3/5

    The toolset covers basic time operations but has notable gaps, such as missing date arithmetic (e.g., add/subtract days), time formatting, or scheduling tasks. While agents can work around this for simple queries, more complex time manipulations are not supported.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides time and timezone functionality for LLMs, enabling them to get current time information across different timezones and convert times between zones.
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides current time information and timezone conversion capabilities using IANA timezone names with automatic system detection. It enables LLMs to fetch local or global times and convert specific timestamps between different regions.
      2
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides current time information and timezone conversion capabilities using IANA timezone names and automatic system detection. It enables LLMs to fetch current times across different regions and convert specific times between timezones.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides current time and timezone conversion using IANA timezone names, enabling LLMs to get system time or convert times between timezones.
      MIT