English Français العربية

io.github.yokingma/time-mcp

Official registry Other

Time MCP Server, giving LLMs time awareness capabilities.

Source code Documentation

What can you do with io.github.yokingma/time-mcp?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package time-mcp
Claude Code 
claude mcp add time-mcp -- npx -y time-mcp@1.0.6
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "time-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "time-mcp@1.0.6"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 🚀 Time MCP Server: Giving LLMs Time Awareness Capabilities
  2. Tools
  3. Installation
  4. Running on Claude Code
  5. Running on Cursor
  6. Running on Windsurf
  7. License

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

Frequently asked questions

What is io.github.yokingma/time-mcp?

Time MCP Server, giving LLMs time awareness capabilities.

How do I install io.github.yokingma/time-mcp?

It runs on your machine. In Claude Code: claude mcp add time-mcp -- npx -y time-mcp@1.0.6. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.yokingma/time-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.yokingma/time-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.yokingma/time-mcp?

It is published by yokingma. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.